Alibaba Cloud Model Studio:Référence de l'API Z-Image

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.

Essayez-le en ligne : (Singapore | Beijing) | Blog technique

Exemples

Présentation du modèle

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.

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --data '{
        "model": "z-image-turbo",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "text": "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."
                        }
                    ]
                }
            ]
        },
        "parameters": {
            "prompt_extend": false,
            "size": "1024*1024"
        }
    }'

{
        "output": {
            "choices": [
                {
                    "finish_reason": "stop",
                    "message": {
                        "content": [
                            {
                                "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx"
                            },
                            {
                                "text": "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."
                            }
                        ],
                        "reasoning_content": "",
                        "role": "assistant"
                    }
                }
            ]
        },
        "usage": {
            "height": 1024,
            "image_count": 1,
            "input_tokens": 0,
            "output_tokens": 0,
            "total_tokens": 0,
            "width": 1024
        },
        "request_id": "abf1645b-b630-433a-92f6-xxxxxx"
    }

{
    "request_id": "a4d78a5f-655f-9639-8437-xxxxxx",
    "code": "InvalidParameter",
    "message": "num_images_per_prompt must be 1"
}

Limites

• Les URL des images sont valides pendant 24 heures. Téléchargez-les rapidement.
• Modération du contenu : Le prompt d'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 erreur IPInfringementSuspect ou DataInspectionFailed. 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.

Codes d'erreur

Consultez la section Codes d'erreur pour résoudre les problèmes liés aux appels échoués.

FAQ

Q : Comment consulter les métriques d'invocation du modèle ?

R : Une heure après la fin d'une invocation de modèle, accédez à la page Monitoring (Singapore) ou Monitoring (China (Beijing)) pour afficher des métriques telles que le nombre d'invocations et le taux de réussite. Pour plus d'informations, consultez la section Facturation et gestion des coûts.

Q : Comment obtenir la liste d'autorisation de noms de domaine pour le stockage des images ?

R : Les images générées par les modèles sont stockées dans OSS. L'API renvoie une URL publique temporaire. Pour configurer une liste d'autorisation de pare-feu pour cette URL de téléchargement, notez ce qui suit : le stockage sous-jacent peut changer dynamiquement. Cette rubrique ne fournit pas de liste d'autorisation de noms de domaine OSS fixe afin d'éviter les problèmes d'accès causés par des informations obsolètes. Si vous avez des exigences en matière de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.