Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Par défaut: 1:1 |
loras | Non | Chargez vos propres fichiers LoRA pour fixer un style ou un personnage. Par défaut: [] |
output_format | Non | Le type de fichier du résultat. jpeg · png · webp · Par défaut: jpeg |
prompt | Oui | Describe the subject, composition and lighting. If a LoRA has a trigger word, put it first. |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
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.
| Option | Crédits par image | ≈ USD |
|---|---|---|
| Standard | 1,8 | 0,018 $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 Turbo LoRA en trois étapes
- 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.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model alibaba/z-image-turbo-lora/text-to-image et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- 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-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 Turbo LoRA
Combien coûte l’API Z-Image Turbo LoRA ?
Z-Image Turbo LoRA coûte à partir de 2 crédits (0,02 $US) par image avec Créer une image, sa tâche la moins chère. 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 Turbo LoRA dans l’API ?
Indiquez alibaba/z-image-turbo-lora/text-to-image pour Créer une image; alibaba/z-image-turbo-lora/edit pour Modifier une image dans le champ model de POST /jobs/createTask.
Quels LoRA fonctionnent ici ?
Les fichiers entraînés pour Z-Image Turbo. Hugging Face en recense des centaines ; transmettez le lien de téléchargement direct vers le fichier .safetensors. Les LoRA conçus pour FLUX, SDXL ou Qwen-Image ne sont pas transposables.
À quoi sert la force en image vers image ?
Elle fixe à quel point le résultat peut s’éloigner de la source. La valeur par défaut de 0,8 conserve la mise en page et la pose tout en changeant le style ; à 0,6, le changement est subtil ; près de 1, la source n’est plus qu’un vague guide.
Puis-je empiler plusieurs LoRA ?
Oui, jusqu’à trois par requête, chacun avec son propre scale. Démarrez les LoRA supplémentaires vers 0,5 ; deux LoRA de style à pleine intensité se font généralement concurrence.
Quelles sont les limites de l’API Z-Image Turbo LoRA ?
Formats d’image: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Z-Image Turbo LoRA sans écrire de code ?
Oui. Le Playground lance Z-Image Turbo LoRA 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 Base LoRA fait tourner le modèle de base complet, plus lent, pour les LoRA entraînées dessus.


