Introduction
Z-Image Spicy transforme un brief sans censure ou ordinaire en une seule image aux dimensions que vous fixez vous-même. C’est un palier dédié sans censure et non un modèle généraliste aux réglages assouplis : entre la requête et le modèle, il n’y a ni indicateur de maturité, ni déclaration, ni analyseur.
Z-Image Spicy est le palier sans censure de la gamme Z-Image : largeur et hauteur exactes en pixels jusqu’à 1536, un champ de prompt sans limite de longueur, un extenseur de prompt facultatif désactivé par défaut, et aucun filtre de contenu sur tout le parcours.
Fonctionnalités et points forts
Un palier dédié aux images sans censure
Z-Image Spicy est conçu pour des briefs visuels sans censure, pas comme une voie généraliste aux contraintes relâchées. Rendez clairs le contexte visé, le sujet et le traitement visuel, puis vérifiez le résultat au regard du brief et de la politique applicable.
Une formulation réfléchie fait partie de la direction artistique
Conservez le brief validé avec le résultat retenu. Une variante ultérieure peut ainsi changer une décision visuelle sans modifier en silence l’intention ni les limites de la requête.
Vérifier la composition là où elle sera utilisée
Évaluez le sujet, la pose, la scène et la lumière à l’endroit où l’image sera utilisée. Une vignette plausible ne suffit pas si l’image retenue perd la relation visuelle requise à la livraison.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Aucun plafond de caractères. 1 caractères minimum |
width | Non | Largeur de sortie en pixels, 256 à 1536, réglée indépendamment de height. Gardez le grand côté à moins du double du petit, sauf si le vide fait partie du cadrage. |
height | Non | Hauteur de sortie en pixels, 256 à 1536, réglée indépendamment de width. |
enable_prompt_expansion | Non | Réécrit un prompt court en un prompt plus long avant la génération. Valeur par défaut: |
seed | Non | Renvoyez la même seed avec le même prompt et les mêmes dimensions pour que le tirage reste identique entre deux appels ; cela les rend comparables, mais ne garantit pas une imag… |
Tarification
| Spécification | Prix |
|---|---|
| $0.01235 / image |
| $0.0133 / image |
Cas d’utilisation
Partir d’un brief écrit
Utilisez ce point de terminaison pour des briefs sans censure ou ordinaires qui demandent une taille exacte en pixels. Réglez width et height entre 256 et 1536, laissez enable_prompt_expansion désactivé pour que la formulation arrive telle quelle, et fixez seed dès qu’un look fonctionne.
Des prompts que d’autres API d’image refusent
Une formulation sans censure que rejettent les points de terminaison filtrés passe sans modification, et avec l’extension désactivée, rien ne la reformule en chemin. Même cycle de vie de tâche que pour tout autre modèle ici : créer, interroger, récupérer depuis le stockage de la plateforme.
Des visuels aux dimensions exactes de l’emplacement
Une illustration de carte en 832x1216, un bandeau en 1536x512, une vignette carrée en 512x512 : tout vient du même point de terminaison, tout est natif et non recadré, ce qui garde le sujet là où la mise en page l’attend.
Séries portrait et mode
Une lumière dure à travers des stores vénitiens, du lin froissé, de la dentelle et de la soie à la taille de votre choix. Fixez un seed dès qu’un look fonctionne, puis faites passer le même sujet par plusieurs pièces et tenues pour construire une série qui se lit comme une seule séance.
Guide de prompt et conseils pratiques
Rédiger le brief complet, expansion désactivée
Il n’y a pas de limite de caractères ; décrivez donc entièrement la tenue, la direction de la lumière, le rendu pellicule et la palette. L’image publiée vient de : « Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette. »
Donner la taille de l’image en pixels
Réglez la largeur et la hauteur selon l’emplacement au lieu de choisir un format : 1024x1536 pour un portrait, 1536x640 pour un bandeau, 512x512 pour une vignette. Chaque côté accepte toute valeur de 256 à 1536.
Adapter l’exemple fourni
Partez de l’exemple publié avec height : 1536 et width : 1024. Remplacez le sujet et la direction créative en conservant le contrat d’entrée de ce mode.
Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.
Le prompt derrière l’image de référence de ce point de terminaison, en 1024x1536 avec l’extension désactivée pour que la formulation parvienne intacte au modèle. L’image présentée a été produite sur le palier Turbo de la même gamme, comme référence de style.
Vérifier le résultat avant d’itérer
1536 pixels, c’est le plafond par côté ; ce n’est donc pas le palier pour un visuel au format d’impression : générez ici et agrandissez ailleurs si une grande image est nécessaire. Les rapports de dimensions extrêmes dépassent ce que le modèle compose bien ; gardez le grand côté autour du double du petit au maximum, sauf si le vide est voulu. Laisser enable_prompt_expansion désactivé est la voie la plus fiable pour les briefs sans censure : l’activer peut généraliser la formulation précise que vous avez choisie. Ce point de terminaison n’a ni prompt négatif ni entrée image.
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/z-image-spicy/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"enable_prompt_expansion": false
}
}'
# 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.
