Choisissez Z-Image Spicy pour les images générées par texte jusqu'à 1536 pixels par côté, à partir de $0.01235 par image. Choisissez Spicy Pro lorsqu'un côté doit dépasser 1536, jusqu'à 2560 pixels, à $0.019. Les deux sont des tâches texte vers image sans censure. Aucune n'accepte d'image de référence, utilisez donc un éditeur distinct lorsqu'un visage approuvé doit rester identique.
Les deux acceptent des briefs sans censure tels qu'ils sont écrits, avec l'expansion du prompt désactivée ; dans nos tests de septembre 2026, Spicy a perdu une partie de la scène une fois sur la demande la plus forte, et Pro non (détails : Z-Image est-il sans censure ?). Ci-dessous : une danseuse adulte fictive entièrement vêtue avec un éventail corail, d'abord un portrait, puis une large image d'annonce.
Choisir la toile et le prix ensemble
| Réglage | Z-Image Spicy | Z-Image Spicy Pro |
|---|---|---|
| Largeur et hauteur | 256–1536 chacune | 256–2560 chacune |
| Valeurs par défaut | 1024 × 1536 | 1024 × 1024 |
| Expansion désactivée | $0.01235/image | $0.019/image |
| Expansion activée | $0.0133/image | $0.019/image |
| Longueur du prompt | Sans limite | Sans limite |
| Seed | 0–2147483647 | Identique |
| Prompt négatif, image source, masque, LoRA | Non disponible | Non disponible |
Envoyez width et height ; il n'y a pas de champ aspect_ratio. Toiles utiles : 960 × 1200 pour une carte 4:5, 864 × 1536 pour un cadre de story 9:16, 1536 × 864 pour 16:9, le tout dans Spicy standard. Choisissez Pro pour 2560 × 1440 ou tout cadre de 1600 pixels de large : Spicy refuse une largeur de 1600, et réduire uniquement la largeur à 1536 modifie le rapport d'aspect en silence.
La facturation est par image, pas par pixel, donc une image Pro de 2560 × 2560 coûte les mêmes $0.019 qu'un carré de 1024, et une petite ébauche n'économise rien. Une autre toile change aussi le rendu même avec le même seed, donc faites l'ébauche dans la taille que vous livrerez. La longueur du grand côté ne devrait pas dépasser environ le double de celle du petit côté, sauf si l’espace vide est justement l’effet recherché.
Essayer d'abord le portrait dans Playground
- Ouvrez la page Z-Image Spicy et restez sur l'onglet Playground, en vue Form. Connectez-vous avec un compte approvisionné pour lancer l'exécution.
- Réglez Width sur 960 et Height sur 1200, laissez Prompt expansion désactivée et saisissez un Seed comme 314159.
- Collez le prompt ci-dessous dans Prompt et lancez le modèle ; vérifiez l'éventail, les mains et les chaussures avant d'utiliser le résultat.
La page sœur texte vers image de Z-Image, pas la page Spicy : la vue Form avec le champ Prompt et le bouton Run.
Image éditoriale de mode naturelle d'une danseuse adulte fictive âgée de 32 ans, répétant seule dans un studio calme. Elle porte une blouse cobalt à manches longues, une jupe ivoire et de simples chaussures de répétition. Corps entier dans un léger quart de tour, les deux chaussures posées sur le sol en bois. Une main tient le manche d'un éventail pliant corail ouvert près de son épaule, la prise visible et l'éventail écarté de son visage. Son autre main tombe relâchée. Mur ocre uni, lumière latérale douce, espace généreux au-dessus de l'éventail et sous les chaussures. Aucune lettre, aucun miroir, aucune personne supplémentaire ni éventail supplémentaire.
Sans champ de prompt négatif, les exclusions vont dans le prompt : la dernière phrase est donc le garde-fou. Les mots qui définissent l'éventail, la main et le cadre font plus de travail qu'une suite d'adjectifs « chef-d'œuvre ». Gardez la première pose assez immobile pour voir quelle main tient l'objet ; explorez un mouvement de danse complet une fois le concept de tenue validé.
Illustration, pas un résultat du modèle ciblé : la prise visible au pivot de l'éventail est la relation que ce prompt demande.
Pour comparer des variantes, modifiez une clause et relancez avec un nouveau seed à chaque fois. Le corps de requête dans Playground est le même JSON que l'API accepte, donc une configuration qui fonctionne ici se copie directement dans le code. Pour Pro, ouvrez la page Z-Image Spicy Pro et utilisez les mêmes champs avec des limites plus élevées.
Puis lancez depuis le code
Installez le SDK Python (pip install spicyapi), définissez SPICY_API_KEY dans l'environnement de votre serveur et exécutez :
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="alibaba/z-image-spicy/text-to-image",
input_data={
"prompt": "Natural editorial fashion image of one fictional adult dancer aged 32, rehearsing alone in a quiet studio. She wears a cobalt long-sleeved blouse, an ivory skirt and simple rehearsal shoes. Complete body in a gentle quarter turn, both shoes resting on the wooden floor. One hand holds the handle of one open coral folding fan beside her shoulder, with the grip visible and the fan away from her face. Her other hand hangs relaxed. Plain ochre wall, soft side light, generous room above the fan and below the shoes. No lettering, mirrors, extra people or additional fans.",
"width": 960,
"height": 1200,
"enable_prompt_expansion": False,
"seed": 314159,
},
idempotency_key=str(uuid.uuid4()),
)
print("Task", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(
not asset.get("url") or asset.get("pending") or asset.get("unavailable")
for asset in assets
):
raise RuntimeError(f"{task['taskId']} has no complete downloadable output; look up this task before retrying")
print(assets[0]["url"]) # copy the image to your own storage nowLa création, l'attente, le téléchargement, les reprises et les codes d'erreur sont dans le guide des tâches et la référence du SDK Python. Les résultats expirent, consultez donc rétention et livraison avant de construire sur le lien renvoyé.
Ou laissez un Agent l'exécuter
Lorsqu'un assistant doit lancer les générations, les trois outils officiels affichent le prix et vous demandent avant un appel payant.
- CLI. Mettez le même objet
inputdansinput.json, puis :
``bash spicyapi tasks create --model alibaba/z-image-spicy/text-to-image --input-file input.json --wait ``
Voir la documentation de la CLI ; npx @spicyapi/cli fonctionne sans installation.
- Serveur MCP. Ajoutez le serveur MCP à votre assistant, puis demandez : « Run Z-Image Spicy at 960 by 1200 with this prompt, prompt expansion off. » Il appelle
spicyapi_task_create, qui s'arrête pour votre confirmation de prix, puisspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalle l'Agent Skill, qui fait lire le schéma du modèle en direct à un assistant de code au lieu de deviner les champs.
Faire de l'image large une composition neuve et délibérée
Passez à width: 1536, height: 864. Dans le prompt du portrait, remplacez « Corps entier dans un léger quart de tour, les deux chaussures posées sur le sol en bois. » par les deux premières phrases ci-dessous et « espace généreux au-dessus de l'éventail et sous les chaussures » par la troisième :
Placez la danseuse entière à gauche du cadre dans un léger quart de tour, les deux chaussures posées sur le sol en bois. Gardez l'éventail entièrement ouvert à l'écart du bord de l'image. Réservez le tiers droit comme un mur ocre calme pour le texte de l'événement ajouté séparément.
Il s'agit d'une nouvelle image générée par texte, pas d'une retouche du portrait, et le même seed ne transportera pas le visage approuvé d'une toile à l'autre. Lorsque l'identité doit correspondre, gardez le portrait retenu et utilisez un éditeur d'images capable d'utiliser des références ou un processus classique de détourage et de composition pour la bannière.
Ajoutez ensuite le vrai titre, la date et le lieu dans votre outil de design ; un mur vide est une demande de composition, pas la promesse d'un texte généré correctement orthographié. Si le mur s'avère trop étroit, déplacez le texte hors de l'image au lieu de recouvrir l'éventail.
Corriger ces échecs avant de passer à Pro
| Échec | Révision précise |
|---|---|
| L'éventail fusionne avec la main | Demandez « une main refermée autour du manche étroit sous le pivot de l'éventail » et gardez l'éventail à l'écart du bord de la blouse. |
| Les chaussures sont coupées | Utilisez un cadrage de portrait 4:5 ou 2:3 ; dites « corps entier avec le sol visible sous les deux chaussures ». Retirez le langage de gros plan. |
| Deux danseuses apparaissent | Retirez les mots groupe, foule, miroir ou partenaire ; conservez « une adulte répétant seule ». |
| La zone du titre est chargée | Retirez fenêtres décoratives, motifs de mur et rayons dramatiques ; demandez un mur uni sur le tiers droit. |
| L'éventail couvre le visage | Placez-le près de l'épaule et hors de la silhouette du visage. |
Pro ne corrige ni l'anatomie ni la composition ; révisez d'abord le brief et ne passez au niveau supérieur que lorsqu'un côté doit dépasser 1536.
Expansion et seeds
Laissez l'expansion du prompt désactivée. Elle réécrit le prompt avant la génération, ce qui peut généraliser une formulation que vous avez choisie sciemment, et c'est ce qui compte le plus pour les briefs à orientation adulte. Ne l'activez que pour un concept en une ligne dont vous accepterez une scène différente ; elle ajoute $0.00095 par image sur Spicy standard et rien sur Pro.
La page du modèle indique qu'un seed omis (ou 0) tire au hasard, mais répéter une demande sans seed a renvoyé la même image sur les deux niveaux lors de nos tests : envoyez donc un seed différent pour chaque variante. Un seed garde une génération comparable mais ne garantit pas une image identique ; enregistrez les fichiers que vous retenez plutôt que de compter sur un nombre pour les recréer.
Illustration, pas un résultat du modèle ciblé : des tirages papier servent à examiner des concepts de portrait.
Budget et décision
Quatre variantes Spicy standard avec expansion désactivée coûtent $0.0494 ; quatre variantes Pro coûtent $0.076. Commencez sur Spicy pour tout ce qui tient dans 1536 pixels ; payez Pro quand le placement exige un côté plus long, et corrigez le brief, pas la version, quand l'anatomie ou la composition sont fausses.
