Introduction
Ce que fait cet endpoint
Qwen Image 2.1 Pro Texte vers image transforme un brief écrit en une à six images par requête, grâce au palier Pro hébergé de Qwen Image 2.1 d’Alibaba. Nos requêtes ont pris de 14 à 43 secondes de bout en bout.
Entrées
prompt porte tout le brief, jusqu’à 5 000 caractères. num_outputs demande de une à six images. aspect_ratio choisit l’une des quinze formes et resolution le palier 1k, 1.5k ou 2k, tous au même prix par image. enable_prompt_expansion (désactivée par défaut) laisse Alibaba réécrire d’abord le prompt, avec prompt_optimization_mode et enable_thinking pour orienter cette réécriture. seed stabilise une série.
Contenu
Aucun filtre côté plateforme. Expansion désactivée, tous nos tests de contenu sont revenus tels qu’écrits.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Image |
| Statut sur SpicyAPI | En ligne : texte vers image et retouche d’image |
| Construit sur | Qwen Image 2.1, en tant que palier Pro hébergé d’Alibaba |
| Images par requête | 1 à 6, facturées à l’image renvoyée |
| Prix | Un prix unique par image en 1k, 1.5k et 2k ; le devis en direct est sur cette page |
| Formats d’image | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Tailles en 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Retouche | 1 à 10 images de référence ; sans format d’image, la sortie suit la source à environ 2K |
| Prompt | Jusqu’à 5 000 caractères ; pas de prompt négatif : écrivez les exclusions dans le prompt |
| Expansion de prompt | Désactivée par défaut ; réécriture direct ou agent quand elle est activée, avec une passe de réflexion facultative |
| Attente mesurée | 14 à 43 secondes en texte vers image, 39 à 48 secondes en retouche, sur l’ensemble de nos essais |
| Politique de contenu | Sans censure : aucun filtre côté plateforme, aucun indicateur de maturité |
| Poids | Non publiés ; Alibaba propose Pro comme API hébergée |
Fonctionnalités et points forts
Un titre bien orthographié du premier coup
Citez les mots et dites où ils se placent. « AFTER DARK » en haut et la petite ligne de couverture en dessous sont revenus lettre pour lettre, dans les deux images de la requête.
Deux portraits, une seule table aux chandelles
Un homme et une femme photographiés séparément, désignés comme Image 1 et Image 2, se retrouvent à une même table sur une terrasse de vignoble, les deux visages toujours reconnaissables et sa robe changée comme demandé.
Pro ou Turbo, sans réécrire une ligne
Pro et Turbo lisent les mêmes champs sur SpicyAPI : un prompt qui fonctionne sur l’un peut être envoyé tel quel à l’autre. Ébauchez vite sur Turbo et gardez les images qui comptent sur Pro, ou l’inverse.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Tout le brief, jusqu’à 5 000 caractères. Écrivez sujet, tenue, pose, lumière et objectif en phrases simples. 1 caractères minimum · 5000 caractères maximum |
aspect_ratio | Non | Quinze formes, des bandeaux 3:1 et 21:9 aux colonnes 1:3 et 9:21. Le cadre est composé à cette forme, il n’est pas recadré à partir d’un carré. |
resolution | Non | 1k, 1.5k ou 2k. Chaque palier coûte le même prix par image : 2k est donc la valeur par défaut. |
num_outputs | Non | De une à six images à partir du même prompt dans une seule requête. Chaque image renvoyée est facturée : six images coûtent donc six fois une image. |
enable_prompt_expansion | Non | Désactivée par défaut, si bien que votre formulation est dessinée telle qu’écrite. Valeur par défaut: |
enable_thinking | Non | Consacre un raisonnement supplémentaire à la réécriture pour une meilleure image, au prix d’une attente plus longue. Ne fonctionne que si l’expansion de prompt est activée. Valeur par défaut: |
prompt_optimization_mode | Non | La manière dont l’expansion réécrit le brief quand elle est activée : direct, une seule passe qui convient à la plupart des prompts ; agent, une réécriture en plusieurs étapes a… |
seed | Non | Stabilise un tirage pour que vous puissiez ne changer qu’un élément à la fois et comparer équitablement. Cela ne garantit pas une image identique au pixel près. |
Tarification
$0.036 / image
Cas d’utilisation
Travail d’image sans censure
SpicyAPI ne place aucun filtre de contenu devant Pro. Avec l’expansion de prompt désactivée, nos tests sont revenus tels qu’écrits à chaque niveau d’intensité testé, du Léger au Maximum, avec des sujets féminins et masculins.
Couvertures et affiches au texte exact
Alibaba annonce une typographie améliorée pour Pro. Citez le titre et la ligne de couverture, dites où chacun se place et décrivez la photographie : notre couverture de magazine est revenue avec les deux lignes orthographiées exactement, dans les deux images de la requête.
Un même personnage sur toute une série
Générez un personnage, puis renvoyez l’image comme référence et changez la tenue, la pièce ou la lumière en passes séparées. Chaque retouche part de votre image validée plutôt que d’un nouveau tirage : le visage se retrouve d’une image à l’autre.
Des couples à partir de deux portraits
Envoyez deux portraits comme Image 1 et Image 2 et décrivez la scène qu’ils partagent. Dans notre test, un homme et une femme photographiés séparément se sont retrouvés à une même table aux chandelles sur une terrasse de vignoble, tous deux reconnaissables.
Portraits et lumières d’ambiance
Alibaba met en avant l’éclairage de portrait et le détail fin comme points forts de Pro. Nommez une source de lumière et l’endroit où elle tombe, une lampe-tempête, une haute fenêtre, une applique, et l’image se construit autour d’elle.
Beaucoup de brouillons avant la bonne image
Jusqu’à six images par appel à un prix unique : un éventail d’options peu coûteux. Explorez tenue, pose et lumière en une seule requête, gardez l’image qui fonctionne et consacrez vos retouches à celle-là.
Guide de prompt et conseils pratiques
Gardez l’expansion de prompt désactivée quand la formulation compte
L’expansion transmet votre prompt au réécrivain d’Alibaba avant le rendu de l’image, et cette réécriture peut atténuer une consigne audacieuse. Elle est désactivée par défaut ici, et chaque test de contenu que nous avons lancé sans elle est revenu tel qu’écrit. Lors de notre unique essai Pro avec l’expansion activée, un prompt que l’application officielle bloquerait est tout de même passé, mais gardez-la désactivée dès que la formulation exacte compte.
Activez-la pour les prompts courts du quotidien
Un brief de six mots donne une scène plus fournie quand l’expansion est activée. direct réécrit en une seule passe et convient à la plupart des prompts ; agent réécrit en plusieurs étapes pour un résultat plus fin. Le mode réflexion consacre un raisonnement supplémentaire à cette réécriture et ajoute du temps ; il ne fait rien tant que l’expansion est désactivée.
Utilisez la 2K, elle coûte autant
Chaque palier coûte le même prix par image : la 2K est donc le réglage par défaut et le choix raisonnable. Descendez en 1k seulement si vous voulez un fichier plus léger ou un retour un peu plus rapide.
Demandez plusieurs images à la fois
Réglez
num_outputsde 1 à 6 pour obtenir des variantes d’un même prompt en un seul appel. Chaque image renvoyée est facturée : six images coûtent six fois une image. C’est le moyen le moins cher de trouver une pose ou une composition qui vous plaît avant de passer à la retouche.Retouchez avec le changement d’abord, la liste de ce qui reste ensuite
Écrivez d’abord le seul élément qui change, puis tout ce qui doit rester : « Remplace sa robe en velours par une robe du soir ivoire ; garde son visage, ses cheveux et son expression. » Nommez les références par leur numéro. Dans notre test à deux portraits, « l’homme de l’image 1 et la femme de l’image 2 » attablés à la bougie sont restés reconnaissables tous les deux dans un même cadre.
Citez les mots qui doivent apparaître
Mettez le texte exact entre guillemets et dites où il se place. Notre couverture de magazine, « AFTER DARK » en haut et « THE SILK ISSUE · NO. 07 » en petites lettres en dessous, est revenue lettre pour lettre. Gardez chaque ligne courte et vérifiez-la en taille réelle avant de publier.
Écrivez le prompt dans un ordre fixe
Sujet, tenue, pose, lumière, objectif et palette, en phrases simples. Nommez la source de lumière et sa direction (une lampe à huile à gauche, un faisceau tournant derrière elle) plutôt qu’un mot d’ambiance. Expansion désactivée, Pro dessine ce que vous écrivez et ne comble pas les vides à votre place.
Introduction
Qwen Image 2.1 Pro Texte vers image transforme un brief écrit en images. Pro est le palier hébergé de Qwen Image 2.1 d’Alibaba, qu’Alibaba a annoncé comme officiellement disponible en même temps que l’API Turbo le 9 octobre 2026 et qu’elle décrit comme un équilibre entre qualité de génération, efficacité d’inférence et coût, avec une typographie, un éclairage de portrait et un détail fin améliorés. Alibaba le propose sous forme d’API et n’a pas publié de poids pour ce modèle.
Sur SpicyAPI, il est en ligne. Une requête renvoie de une à six images, les paliers 1k, 1.5k et 2k coûtent le même prix par image, et aucun filtre de contenu ne se trouve devant le modèle. Chaque image de cette page a été générée avec Pro, avec le prompt affiché.
Choisir un mode selon ce que vous avez
| Matériau de départ | Mode |
|---|---|
| Un brief écrit, rien d’autre | Qwen Image 2.1 Pro Texte vers image |
| Une ou plusieurs images à modifier | Qwen Image 2.1 Pro Retouche d’image |
Ce que nous avons mesuré
Vitesse
De 14 à 31 secondes pour une seule image et de 39 à 43 secondes pour deux images 2K en un seul appel, de bout en bout sur l’ensemble de nos essais. L’expansion de prompt et le mode réflexion ajoutent du temps quand ils sont activés.
Contenu
Avec l’expansion de prompt désactivée, valeur par défaut, chaque test de contenu est revenu tel qu’écrit, du Léger jusqu’au niveau Maximum, avec un sujet féminin et un sujet masculin. Pas une seule requête n’a été refusée. Lors de notre unique essai avec l’expansion activée, un prompt sans filtre a tout de même été rendu comme demandé.
Texte dans l’image
Notre couverture de magazine demandait « AFTER DARK » en titre et « THE SILK ISSUE · NO. 07 » en dessous et a obtenu les deux, lettre pour lettre, dans les deux images de la requête.
Tailles en 2K
| Format | Taille de sortie |
|---|---|
| 1:1 | 2048 × 2048 |
| 16:9 | 2688 × 1536 |
| 9:16 | 1536 × 2688 |
| 4:3 | 2368 × 1760 |
| 3:2 | 2496 × 1664 |
| 2:3 | 1664 × 2496 |
Quinze formats au total, de 3:1 à 1:3, en 1k, 1.5k et 2k. La sortie est en PNG.
Pro ou Turbo
| Pro | Turbo | |
|---|---|---|
| Ce que c’est | Le palier Pro hébergé d’Alibaba | Checkpoint à 8 pas |
| Poids | Non publiés | Ouverts, Qwen Research License |
| Images par requête | 1 à 6 | 1 à 6 |
| Prix selon le palier | Unique | Unique |
| Prix par image | Plus élevé | Plus bas |
| Filtre de contenu | Aucun | Aucun |
La requête est la même : vous pouvez envoyer un prompt aux deux et garder le résultat que vous préférez. Alibaba n’a pas publié de comparaison de qualité entre eux.
Guide des prompts et conseils de pro
Gardez l’expansion désactivée pour une formulation exacte
La réécriture peut atténuer une consigne audacieuse. Désactivée, Pro dessine ce que vous écrivez.
Activez l’expansion pour les prompts courts du quotidien
Une idée de six mots donne une scène plus fournie. direct convient à la plupart des prompts, agent réécrit avec plus de détails, et le mode réflexion consacre du temps supplémentaire à une meilleure réécriture.
Écrivez dans un ordre fixe
Sujet, tenue, pose, lumière, objectif et palette, en phrases simples. Nommez la source de lumière et sa direction plutôt qu’un mot d’ambiance.
Citez les mots qui doivent apparaître
Mettez le texte exact entre guillemets, gardez chaque ligne courte et dites où elle se place.
Demandez-en six, gardez-en une
Les variantes coûtent le même prix chacune : une requête de six images est donc le moyen le plus rapide de trouver la pose ou la composition qui mérite d’être retouchée.
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-2.1-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.
