Introduction
Z-Image Texte vers image transforme une description écrite en une seule image, généralement en une seconde environ. La vitesse est tout l’intérêt : elle rend la génération assez bon marché pour la traiter comme une boucle plutôt que comme un engagement.
Z-Image est la famille d’images compacte 6B de Tongyi, réglée pour un rendu photoréaliste en une seconde environ et publiée ici sous forme d’un seul point de terminaison texte vers image. Cinq formats, PNG sans perte, prompts de 1 000 caractères. Sans censure.
Fonctionnalités et points forts
Vingt itérations au lieu d’un prompt prudent
À une seconde environ par image, on arrête d’écrire des prompts sur la défensive. Écrivez une ligne, regardez, ajustez, regardez encore : la boucle est assez courte pour que l’intuition se forme sur des preuves plutôt que sur des suppositions, et vingt essais ici coûtent encore moins qu’un appel à un modèle de finition lourd.
Une texture d’instantané, pas un vernis de studio
Son registre le plus fort est le moins glamour : selfies dans le miroir au téléphone, néons au plafond, léger flou de bougé, cheveux humides. Demandez un instantané et vous obtenez une image qui semble prise plutôt que rendue — précisément ce que les modèles plus lourds ont tendance à lisser.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 1 000 caractères — un petit budget, exprès. 1 caractères minimum · 1000 caractères maximum |
aspect_ratio | Non | Forme de la sortie : cinq valeurs, carrée par défaut, du 16:9 paysage au 9:16 portrait. |
enable_prompt_expansion | Non | Désactivé par défaut : le prompt est utilisé tel qu’il est écrit. Valeur par défaut: |
output_format | Non |
|
seed | Non | Entier de 0 à 2147483647 pour le départ aléatoire ; sans lui, chaque exécution tire le sien. |
Tarification
$0.01 / image
Cas d’utilisation
Partir d’un brief écrit
Utilisez ce point de terminaison quand vous voulez voir une idée écrite sous de nombreuses variantes rapides : chaque appel renvoie un PNG sans perte en une seconde environ, dans l’un des cinq formats. Gardez chaque prompt qui tombe juste avec sa seed.
Séries de personnages en volume
Portraits de personnages et mises en scène de jeux de rôle explorés vingt directions à la fois, sans rien à signaler ni point de terminaison séparé. Chaque passage tire sa propre image ; gardez les prompts qui fonctionnent et faites varier la tenue et le décor une proposition à la fois.
Recherche avant un modèle de finition
Trouvez la composition ici, où une image coûte environ une seconde, puis reportez la formulation qui a marché sur un modèle plus lent au plafond plus élevé pour la version livrée. Même vocabulaire photographique, aucune restructuration.
Des contenus qui ressemblent à un vrai instantané
Selfies au miroir, néons de salle de sport et ampoules crues au plafond, cadrage décontracté de smartphone : le registre qui passe pour une vraie photo dans un fil. Demandez explicitement les défauts : dominante de néon, flou de mouvement, mise au point inégale.
Guide de prompt et conseils pratiques
Garder un brief court et concret
1 000 caractères, c’est un petit budget : dépensez-le en lumière, objectif et texture. L’image publiée vient de : « iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look. »
Garder le prompt avec l’image retenue
Sans seed, des requêtes identiques tirent des images différentes. Enregistrez le prompt et la seed à côté du fichier et ne changez qu’une proposition à la fois pendant que vous cherchez mieux ; seed fixée, la différence visible vient de cette proposition.
Adapter l’exemple fourni
Partez de l’exemple publié avec aspect_ratio : 1:1 et output_format : png. Remplacez le sujet et la direction créative en conservant le contrat d’entrée de ce mode.
iPhone mirror selfie, an adult woman in a charcoal sports bra and low-slung grey joggers standing in an empty late-night gym, midriff bare, one hand holding the phone, hair damp, casual confident smirk, overhead fluorescent light, slight motion blur, authentic amateur snapshot look.
Une version carrée de la requête derrière l’image publiée : un brief d’instantané qui nomme la source de lumière, le flou et le cadrage au lieu de réclamer de la qualité.
Vérifier le résultat avant d’itérer
Le prompt est plafonné à 1 000 caractères, et un prompt plus long est refusé avant l’envoi au lieu d’être tronqué : ce modèle récompense un brief serré, pas une liste de plans. Chaque format correspond à une taille fixe autour du mégapixel natif du modèle ; il n’y a donc ni sélecteur de résolution ni moyen d’obtenir une grande image de livraison. La typographie fine et les petits détails denses ne sont pas ce pour quoi un modèle 6B est fait.
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-turbo/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "png",
"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.
