Introduction
Qwen Image 3.0 Retouche d’image prend une à trois images de référence et une consigne, et renvoie un résultat retouché. Avec une seule référence, c’est une retouche ciblée ; avec deux ou trois, il fusionne — un visage de l’une, un vêtement ou un arrière-plan d’une autre —, à condition que le prompt dise quelle image fournit quoi.
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. Dites ce qui change et ce qui doit rester identique ; tout ce que vous laissez de côté peut être redessiné. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De une à trois URL publiquement récupérables, pour des images dont vous détenez les droits. 1 éléments minimum · 3 éléments maximum |
aspect_ratio | Non | S’applique au résultat, pas aux sources. |
resolution | Non | 1k ou 2k, 2k par défaut. C’est le choix de palier qui change le prix ; chaque image de référence dans |
num_outputs | Non | Fixé à 1 : une image retouchée 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. 2000 caractères maximum |
seed | Non | Omettez-la pendant l’exploration. Fixez-la pour comparer deux formulations d’une même instruction sur un tirage identique. |
Tarification
| Spécification | Prix |
|---|---|
| $0.03 / image |
| $0.03 / image |
Cas d’utilisation
Affiner un visuel fourni
Utilisez ce mode quand une à trois images existantes doivent fixer le sujet, la mise en page ou la matière. Listez-les dans image_urls dans l’ordre où votre prompt les cite — première, deuxième, troisième — et dites ce que chacune apporte.
Séries de personnages et de mode
Gardez le personnage d’une image validée et changez un détail par requête : la tenue, la lumière ou la pose. Fixez seed quand vous comparez deux formulations du même changement, pour que ce ne soit pas le tirage qui ait bougé.
Variantes de texte localisées
Envoyez l’image validée au point de terminaison de retouche et ne changez que les mots de l’enseigne. La pose, la tenue, la lumière et l’étalonnage sont décrits comme inchangés ; la variante diffère donc par le texte et non par toute l’image.
Décors pour l’hôtellerie et l’aménagement
Envoyez une image validée de chambre ou de bar et ajoutez ou remplacez la signalétique : une affichette de porte, une ardoise de menu, une ligne de néon. Citez le nouveau texte et, si une enseigne existe déjà, citez aussi l’ancienne chaîne.
Guide de prompt et conseils pratiques
Choisir d’abord le format et le palier
aspect_ratio s’applique au résultat, pas aux sources : une référence d’une autre forme revient remise au format demandé, alors choisissez-le sciemment quand le cadrage d’origine doit survivre. Laissez la résolution sur 2k pour tout ce qui porte du texte ; chaque image de référence s’ajoute aussi au devis.
Décrire la scène et citer le texte mot pour mot
Dites d’abord ce qui doit rester identique, puis ce qui change ; tout ce qui n’est pas mentionné peut être redessiné. Pour une modification de texte, citez l’ancienne et la nouvelle chaîne. negative_prompt accepte jusqu’à 2 000 caractères et aide contre les restes de lettrage et les bijoux dédoublés.
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.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
Du texte ajouté sur une surface ni plane ni propre : un verre embué, où chaque trait doit essuyer la condensation et laisser voir le verre sombre, avec une petite coulure au bout. La consigne limite la retouche à la zone libre à gauche du reflet et exige que tout le reste reste en place. Fournissez votre propre image : l’URL est un exemple fictif.
Vérifier le résultat avant d’itérer
Le prompt doit dire quelle référence apporte quoi ; avec deux ou trois sources, le modèle ne déduit pas les rôles tout seul. Modifier un texte sur place fonctionne quand vous écrivez l’ancien et le nouveau libellé. L’identité dérive quand les retouches sont lourdes ; changez donc une chose par passage au lieu de restyler et de réécrire dans le même appel.
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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.
