Introduction
Ce que fait cet endpoint
Qwen Image 2.1 Turbo Texte vers image transforme un brief écrit en une à six images par requête, grâce au checkpoint à 8 pas de Qwen Image 2.1 d’Alibaba. Nos requêtes ont pris de 13 à 39 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, nos tests de contenu sont sortis tels qu'écrits ; activée, la réécriture adoucit les prompts non filtrés.
| 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 checkpoint accéléré à 8 pas du même modèle 7B |
| 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 | 13 à 39 secondes en texte vers image, 26 à 59 secondes en retouche, sur l’ensemble de nos essais |
| Politique de contenu | Sans censure : aucun filtre côté plateforme, aucun indicateur de maturité |
| Poids ouverts | Qwen/Qwen-Image-2.1-Turbo sous la Qwen Research License Agreement |
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 : votre formulation est donc 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.014 / image
Cas d’utilisation
Travail d’image sans censure
SpicyAPI ne place aucun filtre de contenu devant Turbo. Expansion de prompt désactivée, nos tests sont sortis tels qu'écrits à chaque niveau de contenu que nous lançons, de Léger à Maximum, pour les femmes comme pour les hommes. Au niveau Très fort, un essai sur deux est passé ; l'autre s'est arrêté avant la fin de la requête.
Beaucoup de brouillons avant la bonne image
Huit pas et jusqu’à six images par appel offrent un large éventail pour pas cher. Explorez tenue, pose et lumière en une seule requête, gardez le cadre qui fonctionne et consacrez vos retouches à celui-là.
Un personnage sur toute une série
Générez un personnage, puis renvoyez l’image comme référence et changez la robe, 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 donc 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 à rire côte à côte sur un toit au crépuscule, tous deux toujours reconnaissables.
Affiches et typographie
Turbo compose proprement les titres courts. Mettez les mots entre guillemets, dites où ils se placent et décrivez le style de l’affiche : notre affiche de cabaret est revenue avec les deux lignes orthographiées exactement.
Visuels produit et couvertures
Un prix unique jusqu’en 2K et six images par appel conviennent aux miniatures, aux couvertures et aux visuels produit, quand vous voulez plusieurs cadrages d’une même idée et un master pleine taille à recadrer.
Guide de prompt et conseils pratiques
Laissez l’expansion de prompt désactivée pour le travail adulte
L'expansion transmet votre prompt au réécrivain d'Alibaba avant que l'image ne soit dessinée, et le réécrivain adoucit les briefs non filtrés : dans nos tests, il a adouci une image de niveau Fort, transformé une scène de niveau Très fort en une scène seulement suggérée, et renvoyé une modification qui demandait d'aller plus loin sans rien changer. Expansion désactivée, les mêmes prompts sont revenus tels qu’écrits. Elle est désactivée par défaut ici ; gardez-la ainsi, sauf si vous voulez la réécriture.
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.
Prenez la 2K, c’est le même prix
Chaque palier coûte le même prix par image : la 2K est donc le réglage par défaut et le choix logique. Passez en 1k seulement si vous voulez un fichier plus léger ou un retour un peu plus rapide.
Demandez plusieurs images d’un coup
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 donc six fois une image. C’est le moyen le moins cher de trouver la pose ou la composition qui vous plaît avant de commencer à retoucher.En retouche, d’abord le changement, ensuite la liste de ce qu’on garde
Écrivez l’unique chose qui change, puis tout ce qui doit rester : « Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression. » (transforme sa robe de velours sombre en robe de satin carmin dos nu ; garde son visage, ses cheveux et son expression). Désignez les références par leur numéro. Dans notre test à deux portraits, « the man from Image 1 and the woman from Image 2 » (l’homme de l’Image 1 et la femme de l’Image 2) a gardé les deux visages reconnaissables dans un même cadre.
Mettez entre guillemets les mots qui doivent apparaître
Placez le texte exact entre guillemets et dites où il se trouve. Notre affiche de test, « VELVET HOUR » en haut et « LATE SHOW · FRIDAYS 11 PM » en bas, est revenue lettre pour lettre. Gardez chaque ligne courte et vérifiez-la en pleine taille 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 chaude à gauche, une vitre ruisselante derrière elle) plutôt qu’un mot d’ambiance. Expansion désactivée, Turbo dessine ce que vous écrivez et ne comble pas les trous à votre place.
Introduction
Qwen Image 2.1 Turbo Texte vers image transforme un brief écrit en images. L’équipe Qwen d’Alibaba a publié Turbo avec des poids ouverts le 9 octobre 2026, comme checkpoint accéléré de Qwen Image 2.1 : la même architecture de génération visuelle 7B, échantillonnée en 8 pas de débruitage là où les exemples de 2.1 d’Alibaba en utilisent 40.
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 Turbo, 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 Turbo Texte vers image |
| Une ou plusieurs images à modifier | Qwen Image 2.1 Turbo Retouche d’image |
Ce que nous avons mesuré
Vitesse
De 13 à 39 secondes par requête de bout en bout sur l’ensemble de nos essais, dont deux images 2K en un seul appel en 28 secondes. L’expansion de prompt et le mode réflexion ajoutent du temps quand ils sont activés.
Contenu
Expansion de prompt désactivée (par défaut), nos tests de contenu sont sortis tels qu'écrits aux niveaux Léger, Modéré, Fort et Maximum, pour les femmes comme pour les hommes. Le test Très fort a été rendu entièrement une fois sur deux essais ; l'autre s'est arrêté avant la fin de la requête. Avec l’expansion activée, la réécriture d’Alibaba a adouci ces prompts. Aucune requête n’a été refusée.
Texte dans l’image
Notre affiche de cabaret demandait « VELVET HOUR » et « LATE SHOW · FRIDAYS 11 PM » et a obtenu les deux, lettre pour lettre.
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.
Turbo ou Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Pas de débruitage | 8 | 40 |
| Images par requête | 1 à 6 | 1 |
| Prix selon le palier | Unique | Augmente avec le palier |
| Format de sortie | PNG | JPEG, PNG ou WebP |
| Fond transparent | En le demandant dans le prompt | Une option dédiée |
| Filtre de contenu | Aucun | Aucun |
Choisissez Turbo pour le volume et les variantes rapides. Choisissez Qwen Image 2.1 quand vous avez besoin de ses contrôles de format et de fond.
Guide des prompts et conseils de pro
Gardez l’expansion désactivée pour le travail adulte
La réécriture adoucit les briefs pour adultes. Désactivée, Turbo 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.
Mettez entre guillemets les mots qui doivent apparaître
Placez le texte exact entre guillemets, gardez chaque ligne courte et dites où elle se place.
Demandez-en six, gardez-en une
Chaque variante coûte le même prix : 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-turbo/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.


















