Introduction
Qwen Image 3.0 Pro Retouche d’image retouche une à trois images de référence selon une consigne. Avec une référence, c’est une intervention chirurgicale : une ligne de couverture, un vêtement, une lumière. Avec deux ou trois, il fusionne, à condition que le prompt dise ce que chaque source apporte.
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. Nommez le changement et nommez ce qui doit rester identique — tout ce qui n’est pas mentionné 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 : une référence d’une autre forme revient donc reformatée. Accordez-le sciemment quand le cadrage d’origine doit survivre. |
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. Il sert surtout ici contre les artefacts qu’une retouche appelle : coutures de vêtement, lettrages résiduels, bijoux dupliqués. 2000 caractères maximum |
seed | Non | Fixez-la pour comparer deux formulations d’une même instruction sur un tirage identique ; omettez-la quand vous voulez de la vraie variation. |
Tarification
| Spécification | Prix |
|---|---|
| $0.04 / image |
| $0.075 / image |
Cas d’utilisation
Affiner un visuel fourni
Utilisez ce mode quand une à trois images validées doivent passer dans le résultat. Listez-les dans image_urls dans l’ordre où votre prompt les cite et donnez un rôle à chacune — le visage de la première, le vêtement de la deuxième —, car les rôles ne sont jamais déduits.
Couvertures de magazine et éditoriaux sans censure
Gardez une couverture validée et changez un seul élément par passage : une ligne de couverture, un vêtement ou la lumière. C’est en restylant et en réécrivant dans le même appel que les visages dérivent ; séparez donc en deux requêtes.
Maquettes d’affiches et d’affichage extérieur
Prenez une affiche validée et remplacez la ligne de date ou la mention légale pour la prochaine diffusion. Citez l’ancienne et la nouvelle chaîne, gardez aspect_ratio à la forme de l’image et décrivez tout le reste comme inchangé.
Maquettes d’emballages et d’étiquettes
Envoyez un rendu produit et changez son étiquette : citez le nom de marque et l’accroche courte, précisez sur quelle surface ils se trouvent et utilisez negative_prompt contre les restes de lettrage de l’ancienne étiquette.
Guide de prompt et conseils pratiques
Choisir la forme de couverture et rester en 2k
Choisissez 3:4 ou 2:3 pour les couvertures et les affiches ; l’image est composée pour cette forme au lieu d’y être recadrée. Laissez la résolution sur 2k pour tout ce qui porte du texte : l’avantage de ce palier disparaît en 1k.
Citer chaque chaîne et préciser sa place
Pour une modification de texte, citez l’ancienne et la nouvelle chaîne et indiquez la position, puis précisez quels éléments doivent rester intacts, comme le titre. Tout ce que la consigne ne mentionne pas peut être redessiné.
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 portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
Une modification de texte à une seule référence : les deux chaînes sont citées et le titre est explicitement protégé. Fournissez votre propre couverture : la valeur de image_urls est un exemple fictif, pas un fichier hébergé.
Vérifier le résultat avant d’itérer
La fusion fonctionne quand le prompt attribue un rôle à chaque référence ; avec trois sources et aucun rôle nommé, on obtient un mélange que personne n’a demandé. Réécrire sur place exige de citer l’ancienne et la nouvelle chaîne. Les visages dérivent quand on restyle et réécrit dans le même appel ; séparez cela en deux passages.
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/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.
