Générez des images à partir de descriptions textuelles grâce à l'API texte vers image. Ce service, fourni par Alibaba Cloud Model Studio, s'appuie sur les familles de modèles Wan, Qwen-Image et Z-Image.
Performances des modèles
Qwen-Image
Mise en page complexe ![]() | Paragraphe long ![]() | Portrait réaliste ![]() |
Conception d'interface utilisateur ![]() | PPT ![]() | Conception d'illustration ![]() |
Prompts
Prompts
Wanxiang
Photographie de portrait ![]() | Photographie photoréaliste ![]() | Styles artistiques ![]() |
Rendu de texte ![]() | Conception d'affiche ![]() | Génération de jeux d'images ![]() |
Voir le prompt
Voir le prompt
Sélection du modèle
- qwen-image-3.0-pro : Modèle phare de Qwen Image 3.0. Il prend en charge la réécriture intelligente des prompts et excelle dans le rendu de texte qui s'intègre naturellement aux matériaux physiques, tant en chinois qu'en anglais.
- wan2.7-image-pro : Offre le plus grand nombre de fonctionnalités, notamment la génération multi-images, des résolutions allant jusqu'à 4096x4096, ainsi qu'un contrôle amélioré des traits du visage, des couleurs et du rendu de textes longs.
- z-image-turbo : Assure une génération d'images rapide et économique, particulièrement efficace pour les portraits hautement réalistes et les images de produits.
Démarrage rapide
Prérequis
Avant de commencer, obtenez une clé API, puis configurez la clé API comme variable d'environnement. Si vous utilisez le SDK DashScope, vous devez également installer le SDK.
Exemple de code
Méthodes d'appel :
- Tous les modèles texte vers image Wan prennent en charge les appels asynchrones. Les modèles
wan2.7-image-pro,wan2.7-image,wan2.6-imageetwan2.6-t2iprennent également en charge les appels synchrones. Pour plus d'informations, consultez Wan - Génération et édition d'images 2.7, Wan - Génération et édition d'images 2.6 et Wan - Texte vers image V2. - Les modèles texte vers image Qwen des séries qwen-image-3.0 et qwen-image-2.0 prennent en charge les appels synchrones. La série qwen-image-3.0 prend également en charge les appels asynchrones. Pour plus d'informations, consultez Qwen - Génération et édition d'images 3.0.
- Qwen - appel synchrone
- Wan - appel asynchrone
- Python
- Java
- curl
Capacités clés
1. Suivi des prompts
Paramètres : messages.content.text ou input.prompt (obligatoire), et negative_prompt (facultatif).
- prompt : Décrit le contenu souhaité pour l'image, y compris le sujet, la scène, le style, l'éclairage et la composition. Il s'agit du paramètre central pour contrôler la génération texte vers image.
- negative prompt : Décrit ce qu'il faut exclure de l'image, comme « flou » ou « doigts supplémentaires ». Ce paramètre permet d'affiner la qualité du résultat.
Le paramètre negative_prompt n'est pas pris en charge par wan2.7-image-pro et wan2.7-image. Pour exclure des éléments indésirables, décrivez-les dans le prompt (par exemple, « ne pas inclure xxx »).
2. Activer la réécriture de prompt
Paramètre : parameters.prompt_extend (booléen, vrai par défaut).
Cette fonctionnalité étend et optimise automatiquement les prompts courts afin d'améliorer la qualité de l'image. Son activation ajoute 3 à 5 secondes au temps de génération, car un modèle de grande taille réécrit alors le prompt.
Recommandations :
- Activez cette fonctionnalité pour des prompts brefs ou génériques afin d'améliorer considérablement la qualité de l'image.
- Désactivez cette fonctionnalité si vous avez besoin d'un contrôle précis sur les détails de l'image, si vous avez déjà fourni un prompt complet, ou si la latence de réponse constitue une contrainte. Pour la désactiver, définissez le paramètre
prompt_extendsurfalse.
Le paramètreParamètre :prompt_extendn'est pas pris en charge par wan2.7-image-pro et wan2.7-image. Pour améliorer la qualité de l'image avec ces modèles, activez plutôtthinking_mode. Les modèles qwen-image-3.0-pro et qwen-image-3.0 prennent en charge le paramètreprompt_extend(activé par défaut).
parameters.prompt_extend_mode (chaîne, facultatif, par défaut direct). Pris en charge uniquement par qwen-image-3.0-pro et qwen-image-3.0. Spécifie la méthode de réécriture utilisée lorsque prompt_extend est activé :
direct: Amélioration directe du prompt (DPE), adaptée à la plupart des scénarios. Prise en charge pour le texte vers image (T2I) et l'image vers image/édition (I2I).agent: Amélioration du prompt par agent (APE), offre une réécriture plus raffinée. Prise en charge uniquement pour le texte vers image (T2I). Passeragentpour l'image vers image/édition (I2I) retourne une erreur 400.
3. Définir la résolution de l'image de sortie
Paramètre : parameters.size (chaîne), au format "largeur*hauteur".
Modèle | Format de taille | Plage de pixels | Valeur par défaut | Rapport d'aspect |
|---|---|---|---|---|
wan2.7-image-pro | Abrégé |
|
| 1:8 – 8:1 |
Personnalisé | 768768 – 40964096 | |||
wan2.7-image | Abrégé |
|
| 1:8 – 8:1 |
Personnalisé | 768768 – 20482048 | |||
wan2.6-image (mode de sortie texte-image entrelacé) | Personnalisé | 768768 – 12801280 | Correspond au rapport d'aspect d'entrée (≤1280*1280) | 1:4 – 4:1 |
wan2.6-t2i, wan2.5-t2i-preview | Personnalisé | 12801280 – 14401440 | 1280*1280 | 1:4 – 4:1 |
wan2.2 et modèles t2i antérieurs | Personnalisé | [512, 1440], et total de pixels ≤1440*1440 | 1024*1024 | - |
qwen-image-3.0-pro, qwen-image-3.0 | Personnalisé | 512512 – 20482048 | Auto-recommandé par le modèle | 1:8 – 8:1 |
Série qwen-image-2.0 | Personnalisé | 512512 – 20482048 | 2048*2048 | - |
Le modèle wan2.7-image-pro prend en charge la résolution 4K et des résolutions personnalisées jusqu'à 40964096, mais uniquement pour les tâches texte vers image (sans image d'entrée et avec la génération de jeux d'images désactivée). Tous les autres scénarios sont limités à la résolution 2K (20482048).
Résolutions recommandées :
Rapport d'aspect | 4K (wan2.7-image-pro) | 2K (wan2.7-image, qwen-image-3.0-pro, qwen-image-3.0, qwen-image-2.0) | 1K (Wan t2i) |
|---|---|---|---|
1:1 | 4096*4096 | 2048*2048 | 1280*1280 |
16:9 | 4096*2304 | 2688*1536 | 1696*960 |
9:16 | 2304*4096 | 1536*2688 | 960*1696 |
4:3 | 4096*3072 | 2368*1728 | 1472*1104 |
3:4 | 3072*4096 | 1728*2368 | 1104*1472 |
4. Génération de jeux d'images
Paramètre : parameters.enable_sequential (booléen, faux par défaut). Pris en charge uniquement par wan2.7-image-pro et wan2.7-image.
Définissez sur true pour activer le mode de génération de jeux d'images. Dans ce mode, le modèle utilise le prompt et toutes les images de référence pour générer plusieurs images narrativement cohérentes à partir d'une seule requête.
- Nombre d'images : Contrôlé par le paramètre
n. Lorsque ce mode est activé, cette valeur peut varier de 1 à 12, avec une valeur par défaut de 12. Le modèle détermine le nombre réel d'images générées, qui ne dépassera pasn. - Remarque : Lorsque la génération de jeux d'images est activée, les paramètres
thinking_modeetcolor_palettene sont pas disponibles.
5. Mode réflexion
Paramètre : parameters.thinking_mode (booléen, vrai par défaut). Pris en charge uniquement par wan2.7-image-pro et wan2.7-image.
Lorsqu'il est activé, le modèle améliore ses capacités de raisonnement pour augmenter la qualité de l'image. Cela allonge le temps de génération.
Disponible uniquement lorsque la génération de jeux d'images est désactivée ( enable_sequential=false ).
6. Palette de couleurs personnalisée
Paramètre : parameters.color_palette (tableau). Pris en charge uniquement par wan2.7-image-pro et wan2.7-image.
Définissez le schéma de couleurs de l'image en fournissant un tableau d'objets, où chaque objet spécifie une couleur hexadécimale et sa proportion. Vous devez fournir 3 à 10 couleurs (8 recommandées), et la somme de toutes les proportions doit être égale à 100,00 %.
Disponible uniquement lorsque la génération de jeux d'images est désactivée ( enable_sequential=false ).
Cliquez pour voir un exemple d'entrée
Cliquez pour voir un exemple d'entrée
Déploiement en production
-
Tolérance aux pannes
- Gestion de la limitation de débit : Lorsque l'API retourne le code d'erreur
Throttlingou le code d'état HTTP 429, la limitation de débit a été déclenchée. Pour gérer la limitation de débit, consultez Limitation de débit. - Interrogation des tâches asynchrones : Lors de l'interrogation du résultat d'une tâche asynchrone, mettez en œuvre une stratégie d'interrogation raisonnable pour éviter de déclencher la limitation de débit. Par exemple, interrogez toutes les 3 secondes pendant les 30 premières secondes, puis augmentez l'intervalle d'interrogation. Définissez un délai d'attente final pour la tâche (par exemple, 2 minutes). Si la tâche expire, marquez-la comme échouée.
- Gestion de la limitation de débit : Lorsque l'API retourne le code d'erreur
-
Prévention des risques
- Persistance des résultats : Les URL d'images de l'API sont valides pendant 24 heures. Votre système de production doit télécharger l'image immédiatement après réception de l'URL et la transférer vers votre propre service de stockage persistant, tel qu'Alibaba Cloud Object Storage Service (OSS).
- Modération de contenu : Toutes les entrées
promptetnegative_promptsont soumises à la modération de contenu. Si l'entrée n'est pas conforme, la requête est bloquée et une erreurDataInspectionFailedest retournée. - Risques liés aux droits d'auteur et à la conformité du contenu généré : Assurez-vous que vos prompts respectent toutes les lois et réglementations applicables. La génération de contenu incluant des marques déposées, des ressemblances de célébrités ou de la propriété intellectuelle (IP) protégée par le droit d'auteur peut présenter des risques de contrefaçon. Il vous incombe d'évaluer et d'assumer tous les risques associés.
Référence API
- Qwen - Génération et édition d'images 3.0
- Qwen-Image
- Wan2.7 - Génération et édition d'images
- Wan2.6 - Génération et édition d'images
- Wan - Texte vers image v2
- Z-Image - Texte vers image
Facturation et limitation de débit
- Pour les quotas gratuits et les tarifs, consultez tarification des modèles.
- Pour les limites de débit, consultez Génération d'images.
- Vous êtes facturé uniquement pour les images générées avec succès. Les requêtes échouées et les erreurs de traitement n'entraînent pas de frais et ne consomment pas le quota gratuit pour les nouveaux utilisateurs.
Codes d'erreur
Si l'appel du modèle échoue et retourne un message d'erreur, consultez Codes d'erreur pour la résolution.
FAQ
Q : Quelle est la durée de validité des URL d'images ? Comment sauvegarder les images de manière permanente ?
R : Les URL d'images expirent après 24 heures. Vous devez télécharger l'image par programmation immédiatement et la sauvegarder dans un stockage persistant, tel qu'un serveur local ou Alibaba Cloud Object Storage Service.
Q : Mon appel API retourne une erreur DataInspectionFailed. Comment résoudre ce problème ?
R : Cette erreur signifie que votre entrée a déclenché la modération de contenu. Vérifiez votre prompt ou negative_prompt, supprimez tout contenu non conforme, puis réessayez la requête.
Q : Quand dois-je activer ou désactiver le paramètre prompt_extend ?
R : Maintenez-le activé (par défaut) pour des prompts concis ou pour un résultat plus créatif. Définissez-le explicitement sur false lorsque votre prompt est déjà détaillé et spécialisé, ou lorsque vous êtes sensible à la latence de l'API.
Remarque : Les modèles wan2.7-image-pro et wan2.7-image ne prennent pas en charge le paramètre prompt_extend. Pour améliorer la qualité de l'image, activez plutôt thinking_mode.










