popnow
ConnexionCommencer à créer

alibaba/z-image-turbo/text-to-imageÀ partir de 2 crédits par image

Z-Image est la famille d’images compacte 6B de Tongyi, réglée pour sortir du photoréalisme en une seconde environ et publiée en un seul point de terminaison text-to-image. Cinq ratios, PNG sans perte, prompt de 1 000 caractères.

Appelez-le avec le nom de modèle alibaba/z-image-turbo/text-to-image sur POST /jobs/createTask, à partir de 2 crédits par image (0,02 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

  • Créer une image
  • 5 formats d’image
par AlibabaObtenir une clé APIExemples et prompts Z-Image →

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647
promptOuiDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioNonLa forme du cadre : large, carrée ou verticale. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · Par défaut: 1:1
output_formatNonLe type de fichier du résultat. png · Par défaut: png
enable_prompt_expansionNonLaisse le modèle enrichir un prompt court. Par défaut: false

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

OptionCrédits par image≈ USD
Standard1,50,015 $US
enable_prompt_expansion true2,40,024 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 2 crédits par image (0,02 $US).

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API Z-Image en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model alibaba/z-image-turbo/text-to-image et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $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"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Z-Image

Combien coûte l’API Z-Image ?

Z-Image coûte 2 crédits (0,02 $US) par image. Prix par option : Standard 1,5 crédit par image, true 2,4 crédits par image. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de Z-Image dans l’API ?

Indiquez alibaba/z-image-turbo/text-to-image pour Créer une image dans le champ model de POST /jobs/createTask.

Z-Image est-il vraiment aussi rapide ?

Environ une seconde pour une image en text-to-image. C’est tout l’intérêt de la famille : la boucle est assez courte pour traiter la formulation comme une expérience plutôt que comme un engagement.

Que contrôle réellement aspect_ratio ?

Les dimensions en pixels de la sortie. Chaque ratio correspond à une taille fixe autour du mégapixel natif du modèle, donc la qualité reste égale d’un ratio à l’autre au lieu de s’effondrer aux extrêmes.

Puis-je reproduire une image antérieure ?

De très près, si vous avez gardé la seed : avec le même prompt, le même ratio et la même seed, le résultat retombe tout près de l’image précédente, sans garantie au pixel près. Sans seed, deux requêtes identiques rendent des images différentes ; stockez donc le prompt et la seed avec tout asset que vous voulez garder.

Pourquoi la limite du prompt n’est-elle que de 1 000 caractères ?

C’est le maximum qu’accepte ce point de terminaison : un prompt plus long est rejeté avant l’envoi, pas tronqué en silence. Cela correspond aussi à ce qu’un modèle compact 6B exploite bien — ici, une description serrée du sujet, de la lumière et de la texture bat une longue liste de plans.

Quelles sont les limites de l’API Z-Image ?

Formats d’image: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Longueur du prompt (caractères): 1,000. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Z-Image sans écrire de code ?

Oui. Le Playground lance Z-Image avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles Z-Image

Z-Image Turbo LoRA fait tourner la même famille avec tes propres LoRA et ajoute l'image vers image.

En savoir plus sur Z-Image