Modèle léger de génération d'images à partir de texte, conçu pour une production rapide. Il prend en charge le rendu de texte en chinois et en anglais, ainsi que des résolutions flexibles.
Exemples
Prompt d'entrée | Image générée |
|---|---|
Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features four colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza; the third reads “HARAJUKU st” with floating shoes; and the fourth shows a blue mouse riding a skateboard with the text “Takeshita WELCOME.” Dominant bright colors include yellow, teal, orange, pink, and green. Speech bubbles, halftone patterns, and playful characters enhance the urban street-art aesthetic. Daylight evenly illuminates the scene, and the ground beneath her feet is white tiled pavement. Full-body portrait, centered composition, slightly tilted stance, direct eye contact with the camera. High detail, sharp focus, dynamic framing. | ![]() |
Présentation du modèle
Nom du modèle | Description | Spécifications de l'image générée |
|---|---|---|
z-image-turbo | Modèle léger et rapide de génération d'images | Résolution d'image : de 512×512 à 2 048×2 048 pixels. Consultez les résolutions recommandées dans la section Paramètres de taille. Format d'image : png Nombre d'images : fixe à 1. |
Prérequis
Créez une clé API et configurez-la comme variable d'environnement.
Appel HTTP synchrone
Singapour :POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Pékin :POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Remplacez {WorkspaceId} par votre véritable identifiant d'espace de travail.
Paramètres de la requête |
Cet exemple renvoie directement une image pour accélérer la réponse. Pour activer la réécriture intelligente, définissez prompt_extend=true — le système retourne alors le prompt optimisé, le raisonnement et l'image (ce qui augmente le temps de réponse). |
En-têtes de la requête | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle : z-image-turbo. | |
input object (Obligatoire)Contenu d'entrée.
Propriétés messages array (Obligatoire)Tableau du contenu de la requête. Tour unique uniquement — transmettez un seul ensemble rôle-contenu. Les conversations multi-tours ne sont pas prises en charge.
Propriétés role string (Obligatoire)Rôle du message : user.contentarray (Obligatoire)Tableau du contenu du message. Doit contenir un objet texte.
Propriétés text string(Obligatoire)Prompt positif décrivant le contenu, le style et la composition souhaités.Prend en charge le chinois et l'anglais. Maximum 800 caractères (chaque caractère, lettre, chiffre ou symbole compte pour un). Les caractères excédentaires sont tronqués.Exemple : Un chat orange assis avec une expression joyeuse, vif et mignon, réaliste et précis.Remarque : Un seul objet texte est pris en charge. Passer zéro ou plusieurs objets texte entraîne une erreur. | |
parameters object (Facultatif)Paramètres de génération d'image.
Propriétés size string (Facultatif)Résolution de l'image générée au format largeur×hauteur.
Résolutions recommandées pour un total de 1 024*1 024 pixels :
Résolutions recommandées pour un total de 1 280*1 280 pixels :
Résolutions recommandées pour un total de 1 536*1 536 pixels :
bool (Facultatif)Active la réécriture intelligente du prompt via l'optimisation LLM et la sortie de raisonnement.
integer (facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647].L'utilisation de la même seed produit des résultats similaires. Si ce paramètre est omis, l'algorithme utilise une graine aléatoire.Remarque : La génération d'images est probabiliste. Même avec la même seed, les résultats peuvent varier. |
Paramètres de la réponse |
Les données de la tâche (statut et URL des images) ne sont conservées que pendant 24 heures, puis automatiquement supprimées. Enregistrez rapidement les images générées. |
output objectSortie du modèle.
Propriétés choices arrayContenu de la sortie du modèle. Le tableau contient un élément.
Propriétés finish_reason stringRaison de la fin de traitement. La valeur stop indique un succès.message objectMessage de réponse du modèle.
Propriétés role stringRôle du message. La valeur est assistant.contentarray
Propriétés image stringURL de l'image générée (PNG). Valide 24 heures — téléchargez-la rapidement.text stringRenvoie le prompt d'entrée (prompt_extend=false) ou le prompt réécrit (prompt_extend=true).stringProcessus de raisonnement du modèle. Renvoyé uniquement lorsque prompt_extend=true. | |
usage objectInclut les statistiques d'utilisation pour les générations réussies uniquement.
Propriétés width integerLargeur de l'image générée (pixels).height integerHauteur de l'image générée (pixels).image_count integerNombre d'images générées : 1.input_tokens integerTokens d'entrée (0 lorsque prompt_extend=false).output_tokens integerTokens de sortie (0 lorsque prompt_extend=false).output_tokens_detailsobjectDétails des tokens de sortie (uniquement lorsque prompt_extend=true).
Propriétés reasoning_tokens integerTokens utilisés pour le raisonnement.integerTotal des tokens (0 lorsque prompt_extend=false). | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement pour les requêtes échouées. Voir Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes échouées. Voir Codes d'erreur. |
Limites
- Les URL des images sont valides pendant 24 heures. Téléchargez-les rapidement.
- Modération du contenu : Le
promptd'entrée et l'image générée font tous deux l'objet d'une modération. Tout contenu non conforme entraîne une erreurIPInfringementSuspectouDataInspectionFailed. Consultez la section Codes d'erreur.
Facturation et limitation du débit
- Pour connaître les tarifs et le quota gratuit, consultez la section Tarification des modèles.
- Pour les limites de débit, reportez-vous à la section Z-Image.
- La facturation repose sur le nombre d'images générées avec succès et sur l'état de prompt_extend. Les appels échoués n'engendrent aucun frais et ne consomment pas de quota gratuit.
