Introduction
Qwen Image 3.0 Pro Texte vers image est le palier de finition de la gamme. Il accepte la même requête que Qwen Image 3.0 et consacre davantage au détail, surtout pour la typographie à plusieurs éléments et le rendu des matières : peau, tissu et verre.
Qwen Image 3.0 Pro est le palier haute définition de la gamme d’images Qwen d’Alibaba : des prompts de 5 000 caractères, huit formats, un palier 1K ou 2K et une retouche à une à trois références. Conçu pour les images livrées, sans censure.
Choisir un mode Qwen Image 3.0 Pro selon le matériau de départ
| Matériau de départ | Mode |
|---|---|
| Une direction artistique ou un brief de design écrit | Qwen Image 3.0 Pro Texte vers image |
| Une image source validée à retravailler | Qwen Image 3.0 Pro Retouche d’image |
Fonctionnalités et points forts
Une composition qui tient compte du texte
Qwen Image 3.0 Pro convient aux concepts visuels où le texte fourni, la composition et le traitement de l’image doivent être pensés ensemble. Considérez le lettrage généré comme une maquette et relisez-le avant publication.
Composer une image et retravailler une source sont deux tâches distinctes
Utilisez le texte vers image pour poser un visuel à partir d’un brief écrit. Utilisez la retouche d’image quand une image existante apporte l’identité, la mise en page ou la matière à conserver pendant une modification précise.
Vérifier la hiérarchie avant le détail décoratif
Pour les affiches, les emballages et les concepts de campagne, fixez d’abord la hiérarchie des messages et la zone focale. Un résultat séduisant reste hors sujet si le texte validé ou les informations produit ne sont pas représentés correctement.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères, en chinois ou en anglais. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | Compose l’image plutôt que de la recadrer. Le 3:4 et le 2:3 sont les formes pour lesquelles couvertures et affiches sont mises en page ; les huit coûtent le même prix par image. |
resolution | Non | 1k ou 2k, 2k par défaut, et seule variante de prix. L’avantage de ce palier est largement invisible en 1k — n’utilisez le 1k que pour des roughs de composition. |
num_outputs | Non | Fixé à 1 : une image par requête. |
enable_prompt_expansion | Non | Active par défaut dans cette famille. Elle étoffe les briefs maigres et réécrit les briefs détaillés : coupez-la dès que votre prompt est une description de plan précise. Valeur par défaut: |
negative_prompt | Non | Jusqu’à 2 000 caractères d’exclusions. Sur du travail typographique, il gagne sa place contre les lettrages dupliqués, les filigranes parasites et les bords d’étiquette baveux. 2000 caractères maximum |
prompt_optimization_mode | Non | Façon dont l’expansion du prompt réécrit votre brief tant que |
seed | Non | Omettez-la pendant l’exploration ; fixez-la dès qu’une mise en page tombe juste, puis changez une accroche à la fois pour voir l’effet de chaque retouche isolément. |
Tarification
| Spécification | Prix |
|---|---|
| $0.04 / image |
| $0.075 / image |
Cas d’utilisation
Partir d’un brief écrit
Utilisez ce palier quand l’image sera livrée telle qu’elle revient et porte plusieurs éléments de texte : un titre, une ligne de date, une accroche courte. Laissez la résolution sur 2k, citez chaque chaîne et précisez où elle se place.
Maquettes d’emballages et d’étiquettes
Étiquettes de bouteilles, de boîtes et de canettes où le nom de marque et une accroche courte doivent se lire sur une surface courbe. Citez chaque chaîne, nommez la matière et laissez le prompt négatif écarter les lettres dédoublées égarées.
Couvertures de magazine et éditoriaux sans censure
Un portrait pleine page avec un vrai bandeau, un numéro de parution et deux titres de couverture, généré en un seul appel. Le style peut changer sans rien changer à la requête : le même endpoint gère à la fois la typographie et le style.
Maquettes d’affiches et d’affichage extérieur
Des images en 3:4 et 2:3 avec titre, ligne de date et mention légale déjà posés dans l’image, au palier 2k. De quoi passer en validation avant que quelqu’un ne pose une vraie typographie sur une image propre.
Guide de prompt et conseils pratiques
Citer chaque chaîne et préciser sa place
Nommez séparément le titre, les lignes de couverture et les petites capitales, chacun entre apostrophes simples et chacun avec une position. Trois ou quatre chaînes courtes par image, c’est la plage fiable ; negative_prompt peut écarter les lettres dédoublées et les filigranes égarés.
Fixer le seed, puis faire varier une ligne
Quand la mise en page tient, notez le seed et changez une seule ligne de couverture à la fois. Si vous voulez plutôt plusieurs lectures de la même mise en page qu’une image arrêtée, laissez le seed de côté et envoyez le brief en requêtes parallèles.
Adapter l’exemple fourni
Partez de l’exemple publié avec aspect_ratio : 3:4 et resolution : 2k. Remplacez le sujet et la direction créative en conservant le contrat d’entrée de ce mode.
A glossy fashion magazine cover, full-bleed portrait of an adult woman in a black lace bodysuit under a sheer open kimono, arms raised adjusting her hair, studio rim light on a deep charcoal background; masthead text 'SPICY' in large condensed type across the top, cover lines reading 'THE LATE SHIFT' and 'ISSUE 07' in small caps, high-end print typography, razor-sharp 2K detail.
C’est la requête exacte derrière la couverture présentée pour ce point de terminaison : un portrait à fond perdu en 3:4 au palier 2k, avec titre, ligne de numéro et lignes de couverture toutes citées dans le prompt.
Vérifier le résultat avant d’itérer
La typographie à plusieurs éléments est la raison d’être de ce palier, et elle a quand même un plafond : trois ou quatre chaînes courtes par image, c’est fiable ; une page entière de texte, non. Générez la typographie en 2k : le palier 1k sert aux esquisses de composition. Les glyphes rares et les écritures non latines sont rendus, mais doivent être relus avant toute livraison.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
