Introduction
Qwen Image 3.0 Texte vers image transforme un brief écrit en une image par requête. Ce qui le distingue, c’est la typographie : les chaînes placées entre guillemets — une affichette de porte, une enseigne de bar, un titre d’affiche — sont rendues comme du vrai texte et non comme une texture en forme de lettres.
Qwen Image 3.0 est le modèle d’image d’Alibaba spécialisé dans le rendu du texte : des prompts de 5 000 caractères, huit formats, un palier 1K ou 2K et un point de terminaison de retouche qui lit une à trois références. Sans censure, sans indicateur à activer.
Choisir un mode Qwen Image 3.0 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 Texte vers image |
| Une image source validée à retravailler | Qwen Image 3.0 Retouche d’image |
Fonctionnalités et points forts
Une composition qui tient compte du texte
Qwen Image 3.0 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, sans indicateur de langue. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | Compose l’image avant la génération plutôt que de la recadrer ensuite : choisissez donc la forme à laquelle l’image sera publiée. Les huit ratios coûtent le même prix par image. |
resolution | Non | 1k ou 2k, 2k par défaut, et seule variante de prix ici. |
num_outputs | Non | Fixé à 1 : chaque requête rend une image. Pour une planche-contact depuis un seul brief, lancez des requêtes en parallèle sans seed ; chacune est chiffrée et réglée séparément. |
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, tenues hors du prompt principal. 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 et chaque appel tirera la sienne. |
Tarification
| Spécification | Prix |
|---|---|
| $0.03 / image |
| $0.03 / image |
Cas d’utilisation
Partir d’un brief écrit
Utilisez ce mode quand l’image n’a encore aucune source et qu’une partie de son texte doit se lire : une enseigne, une étiquette, un titre. Choisissez le format dans lequel vous publierez, laissez la résolution sur 2k et placez chaque chaîne entre apostrophes simples dans le prompt.
Séries de personnages et de mode
Les prompts de stylisme que d’autres API refusent passent ici sans indicateur. Figez le seed qui vous a donné le personnage, puis changez un seul détail par requête — tenue, lumière, pose — pour obtenir un ensemble cohérent plutôt qu’un tas de tirages sans rapport.
Maquettes d’affiches et d’emballages
Titre, sous-titre et mention légale, tous rendus dans l’image en 2k, au format qu’utilise réellement l’emplacement. Utile pour présenter une mise en page avant qu’un graphiste ne pose une vraie typographie sur une image propre.
Décors pour l’hôtellerie et l’aménagement
Chambres d’hôtel, bars et halls où une enseigne précise doit se lire correctement : affichettes de porte, numéros de chambre, cartes de cocktails, néon au-dessus du comptoir. Générez l’image avec le texte déjà en place au lieu de composer la typographie par-dessus un rendu après coup.
Guide de prompt et conseils pratiques
Choisir d’abord le format et le palier
aspect_ratio compose l’image au lieu de la recadrer ; choisissez donc la forme dans laquelle vous publierez. Laissez la résolution sur 2k dès que l’image contient du texte, et ne descendez à 1k que pour des esquisses de mise en page où rien ne doit être lisible.
Décrire la scène et citer le texte mot pour mot
Décrivez le sujet, la tenue, la lumière et l’objectif, puis placez chaque chaîne exacte entre apostrophes simples, en huit mots environ. enable_prompt_expansion est activé par défaut et réécrit les prompts détaillés ; désactivez-le dès que votre texte est une description précise du plan.
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.
Editorial photograph, an adult woman sitting on a hotel bed in a navy satin slip dress, city lights blurred through the window behind her, a brass door hanger hanging in sharp foreground reading 'DO NOT DISTURB', warm tungsten bedside lamp, cinematic 35mm, shallow focus, moody blue and amber palette.
C’est la requête exacte derrière l’image publiée : une scène d’hôtel en 3:4 au palier 2k, avec le texte de l’affichette de porte cité dans le prompt.
Vérifier le résultat avant d’itérer
Les chaînes courtes entre guillemets sont le cas fiable : un titre, une enseigne, une étiquette, environ huit mots ou moins par élément. Un texte de la longueur d’un paragraphe se dégrade encore en charabia vraisemblable, et les petits caractères serrés sont les premiers à casser au palier 1k : générez la typographie en 2k. Les écritures non latines sont rendues, mais relisez-les : sur les glyphes rares, le modèle est plus assuré qu’exact.
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/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.
