Skip to main content

Wan2.7 - génération et édition d'images

Wan2.7-Image prend en charge la génération texte-vers-image, texte-vers-ensemble d'images, image-vers-ensemble d'images, l'édition d'images ainsi que la génération par référence multi-images.

Présentation des modèles

Modèle

Description

Spécifications des images générées

wan2.7-image-pro

Wan 2.7 image Pro. Prend en charge la sortie 4K pour la génération texte-vers-image (uniquement, hors ensembles d'images).

Format d'image : PNG.

Pour la résolution et les dimensions des images, consultez le paramètre size.

wan2.7-image

Wan 2.7 image. Offre une génération plus rapide.

Avant d'appeler un modèle, vérifiez sa disponibilité régionale dans la rubrique Liste des modèles et tarifs.

Prérequis

Obtenez une clé API et exportez-la en tant que variable d'environnement.
Les régions Chine (Pékin) et Singapour disposent de clés API et d'endpoints de requête distincts. Ces éléments ne sont pas interchangeables. Tout appel interrégional entraîne des échecs d'authentification ou des erreurs de service.

HTTP synchrone

Renvoie le résultat en une seule requête. Cette méthode est recommandée pour la plupart des cas d'usage.
  • Singapore
  • Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Paramètres de la requête

  • Texte vers image
  • Édition d'image
  • Édition interactive
  • Génération d'ensembles d'images
Le modèle wan2.7-image-pro prend en charge la résolution 4K uniquement pour la génération texte-vers-image. L'édition d'images et la génération d'ensembles d'images sont limitées à une résolution maximale de 2K.
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": "wan2.7-image-pro",
            "input": {
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {"text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"}
                        ]
                    }
                ]
            },
            "parameters": {
                "size": "2K",
                "n": 1,
                "watermark": false,
                "thinking_mode": true
            }
        }'
En-têtes
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à 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. Valeurs valides : wan2.7-image-pro, wan2.7-image.
input object (Obligatoire)Objet d'entrée.

Propriétés

messages array (Obligatoire)Tableau contenant le contenu de la requête. Seules les conversations à tour unique sont prises en charge.

Propriétés

role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau contenant le contenu du message.

Propriétés

text stringInvite textuelle. Prend en charge le chinois et l'anglais. Maximum de 5 000 caractères. Chaque caractère, lettre, chiffre ou symbole compte pour une unité. Les caractères excédentaires sont tronqués.image stringURL ou chaîne encodée en Base64 de l'image d'entrée.Limites relatives aux images :
  • Formats acceptés : JPEG, JPG, PNG (canaux alpha non pris en charge), BMP, WEBP.
  • Résolution : la largeur et la hauteur doivent être comprises entre 240 et 8 000 pixels. Le rapport d'aspect doit se situer entre 1:8 et 8:1.
  • Taille du fichier : 20 Mo maximum.
Limites concernant le nombre d'images :
  • Vous pouvez fournir de 0 à 9 images en entrée.
  • Lors de l'envoi de plusieurs images, transmettez plusieurs objets image dans le tableau content. L'ordre des objets dans ce tableau détermine celui des images.
Formats d'entrée pris en charge :
  1. Utilisation d'une URL accessible publiquement
    • Protocoles HTTP ou HTTPS acceptés.
    • Exemple : http://wanx.alicdn.com/material/xxx.jpeg.
  2. Transmission d'une chaîne d'image encodée en Base64
    • Format : data:{MIME_type};base64,{base64_data}
    • Exemple : data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (Fourni à titre indicatif uniquement. Vous devez transmettre la chaîne complète.)
    • Pour plus d'informations, consultez la rubrique Méthodes d'entrée d'image.
parameters object (Facultatif)Configuration des paramètres du modèle.

Propriétés

bbox_list List[List[List[int]]] (Facultatif)Zone de cadre de délimitation pour l'édition interactive.
  • La longueur de la liste doit correspondre au nombre d'images fournies en entrée. Si une image ne nécessite aucune modification, transmettez une liste vide [] à la position correspondante.
  • Format des coordonnées : [x1, y1, x2, y2] (x supérieur gauche, y supérieur gauche, x inférieur droit, y inférieur droit). Utilisez les coordonnées absolues en pixels de l'image originale. Le coin supérieur gauche correspond à (0, 0).
  • Une seule image peut contenir jusqu'à deux cadres de délimitation.
Exemple : Entrée de 3 images, où la deuxième image n'a pas de cadre de délimitation et la première en possède deux :
[
  [[0, 0, 12, 12], [25, 25, 100, 100]],  # Image 1 (2 boxes)
  [],                                    # Image 2 (no box)
  [[10, 10, 50, 50]]                     # Image 3 (1 box)
]
enable_sequential boolean (Facultatif)Contrôle le mode de génération d'images :
  • false (par défaut) : Mode de sortie standard.
  • true : Mode de sortie d'ensemble d'images.
size string (Facultatif)Résolution de l'image générée. Deux méthodes mutuellement exclusives sont disponibles :Modèle : wan2.7-image-pro
  • Méthode 1 : Spécifier la résolution de l'image générée (Recommandé)
    • Prend en charge les spécifications 1K, 2K (par défaut) et 4K.
    • Cas d'application :
      • Texte vers image (sans image en entrée, hors génération d'ensembles) : prend en charge 1K, 2K et 4K.
      • Autres scénarios : prend en charge 1K et 2K.
    • Nombre total de pixels par spécification : 1K : 1024×1024, 2K : 2048×2048, 4K : 4096×4096
    • Rapport d'aspect de l'image :
      • Avec une image en entrée : le rapport d'aspect généré correspond à celui de l'image fournie (la dernière s'il y en a plusieurs) et est mis à l'échelle selon la résolution sélectionnée.
      • Sans image en entrée : l'image générée est carrée.
  • Méthode 2 : Spécifier la largeur et la hauteur en pixels de l'image générée
    • Texte vers image : le nombre total de pixels se situe entre 768×768 et 4096×4096. Le rapport d'aspect doit être compris entre 1:8 et 8:1.
    • Autres scénarios : le nombre total de pixels se situe entre 768×768 et 2048×2048. Le rapport d'aspect doit être compris entre 1:8 et 8:1.
Modèle : wan2.7-image
  • Méthode 1 : Spécifier la résolution de l'image générée (Recommandé)
    • Prend en charge les spécifications 1K et 2K (par défaut). La 4K n'est pas prise en charge.
  • Méthode 2 : Spécifier la largeur et la hauteur en pixels de l'image générée
    • Dans tous les scénarios, le nombre total de pixels se situe entre 768×768 et 2048×2048. Le rapport d'aspect doit être compris entre 1:8 et 8:1.
Les valeurs en pixels de l'image générée peuvent présenter de légères différences par rapport aux valeurs spécifiées.
n int (Facultatif)
Le paramètre n impacte directement le coût : prix unitaire × nombre d'images générées avec succès. Consultez les tarifs du modèle avant tout appel.
  • Si le mode ensemble d'images est désactivé, cette valeur représente le nombre d'images à générer. Plage : de 1 à 4. Valeur par défaut : 1.
  • Si le mode ensemble d'images est activé, cette valeur définit le nombre maximal d'images à générer. Plage : de 1 à 12. Valeur par défaut : 12. Le nombre réel dépend du modèle et ne dépassera jamais n.
thinking_mode boolean (Facultatif)Active le mode réflexion. Valeur par défaut : true. Ce paramètre n'est effectif que si le mode ensemble d'images est désactivé et qu'aucune image n'est fournie en entrée. Lorsqu'il est activé, le modèle renforce ses capacités d'inférence afin d'améliorer la qualité des résultats, ce qui augmente toutefois le temps de génération.color_palette array (Facultatif)Thème de couleurs personnalisé. Tableau d'objets comprenant chacun une couleur hexadécimale et une proportion. Doit contenir entre 3 et 10 couleurs. Il est recommandé d'en utiliser 8.Cette option n'est disponible que lorsque le mode ensemble d'images est désactivé (enable_sequential=false).

Propriétés

hex string (Obligatoire)Valeur de la couleur au format hexadécimal (HEX).ratio string (Obligatoire)Pourcentage attribué à la couleur. Doit comporter exactement deux décimales (par exemple "25.00%"). La somme de toutes les valeurs ratio doit être égale à 100,00 %.
"color_palette": [
    {
        "hex": "#C2D1E6",
        "ratio": "23.51%"
    },
    {
        "hex": "#CDD8E9",
        "ratio": "20.13%"
    },
    {
        "hex": "#B5C8DB",
        "ratio": "15.88%"
    },
    {
        "hex": "#C0B5B4",
        "ratio": "13.27%"
    },
    {
        "hex": "#DAE0EC",
        "ratio": "10.11%"
    },
    {
        "hex": "#636574",
        "ratio": "8.93%"
    },
    {
        "hex": "#CACAD2",
        "ratio": "5.55%"
    },
    {
        "hex": "#CBD4E4",
        "ratio": "2.62%"
    }
]
watermark bool (Facultatif)Ajoute un filigrane dans le coin inférieur droit de l'image avec le texte fixe « AI Generated ».
  • false (par défaut)
  • true
seed integer (facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647].L'utilisation d'une même seed produit des sorties similaires. En l'absence de cette valeur, l'algorithme utilise une graine aléatoire.Remarque : La génération d'images repose sur des probabilités. Même avec une seed identique, les résultats peuvent varier.

Paramètres de la réponse

  • Exécution réussie de la tâche
  • Exécution anormale de la tâche
Les données de la tâche (statut et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement supprimées. Pensez à enregistrer rapidement les images générées.
{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ],
        "finished": true
    },
    "usage": {
        "image_count": 1,
        "input_tokens": 10867,
        "output_tokens": 2,
        "size": "1488*704",
        "total_tokens": 10869
    },
    "request_id": "71dfc3c6-f796-9972-97e4-bc4efc4faxxx"
}
output objectInformations de sortie de la tâche.

Propriétés

choices arrayContenu généré par le modèle.

Propriétés

finish_reason stringRaison de l'arrêt de la tâche. La valeur stop indique une fin normale.message objectMessage renvoyé par le modèle.

Propriétés

role stringRôle du message. Toujours défini à assistant.content array

Propriétés

type stringValeur : image.image stringURL de l'image générée. Format : PNG.Ce lien reste valide pendant 24 heures. Téléchargez l'image sans tarder.
finished booleanIndique si la tâche est terminée. Valeur par défaut : false.
usage objectStatistiques d'utilisation de la requête. Seuls les résultats réussis sont comptabilisés.

Propriétés

image_count integerNombre d'images générées.size stringRésolution de l'image générée. Exemple : 1376*768.input_tokens integerNombre de tokens en entrée (non facturés). La facturation repose sur le nombre d'images.output_tokens integerNombre de tokens en sortie (non facturés). La facturation repose sur le nombre d'images.total_tokens integerNombre total de tokens (non facturés). La facturation repose sur le nombre d'images.
request_id stringIdentifiant unique de la requête permettant le suivi et le dépannage.
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur.
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur.

HTTP asynchrone

Idéal pour les tâches de longue durée. Soumettez une tâche, puis interrogez régulièrement son état et ses résultats.

Étape 1 : Créer une tâche pour obtenir l'ID de tâche

  • Singapore
  • Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Paramètres de la requête

  • Text-to-image
  • Édition d'image
  • Édition interactive
  • Génération de jeux d'images
Le modèle wan2.7-image-pro prend en charge la résolution 4K uniquement pour la génération texte-vers-image. L'édition d'images et la génération de jeux d'images sont limitées à une résolution maximale de 2K.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
        --header 'Content-Type: application/json' \
        --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
        --header "X-DashScope-Async: enable" \
        --data '{
            "model": "wan2.7-image-pro",
            "input": {
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {"text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"}
                        ]
                    }
                ]
            },
            "parameters": {
                "size": "2K",
                "n": 1,
                "watermark": false,
                "thinking_mode": true
            }
        }'
En-têtes
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json.
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx.
X-DashScope-Async string (Obligatoire)Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable.
Si cet en-tête de requête est absent, l'erreur « current user api does not support synchronous calls » est renvoyée.
Corps de la requête
model string (Obligatoire)Nom du modèle. Valeurs valides : wan2.7-image-pro, wan2.7-image.
input object (Obligatoire)Objet d'entrée.

Propriétés

messages array (Obligatoire)Tableau contenant le contenu de la requête. Seules les conversations à tour unique sont prises en charge.

Propriétés

role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau du contenu des messages.

Propriétés

text stringInvite textuelle. Prend en charge le chinois et l'anglais. Maximum de 5 000 caractères. Chaque caractère, lettre, chiffre ou symbole compte pour un. Les caractères excédentaires sont tronqués.image stringURL ou chaîne encodée en Base64 de l'image d'entrée.Limites relatives aux images :
  • Formats d'image : JPEG, JPG, PNG (les canaux alpha ne sont pas pris en charge), BMP, WEBP.
  • Résolution d'image : la largeur et la hauteur doivent être comprises entre 240 et 8 000 pixels. Le rapport d'aspect doit se situer entre 1:8 et 8:1.
  • Taille du fichier : 20 Mo maximum.
Limites sur le nombre d'images :
  • Vous pouvez fournir de 0 à 9 images en entrée.
  • Lorsque vous fournissez plusieurs images, vous devez transmettre plusieurs objets image dans le tableau content. L'ordre des objets dans le tableau détermine l'ordre des images.
Formats d'entrée pris en charge :
  1. Utiliser une URL accessible publiquement
    • Prend en charge les protocoles HTTP et HTTPS.
    • Exemple : http://wanx.alicdn.com/material/xxx.jpeg.
  2. Transmettre une chaîne d'image encodée en Base64
    • Format : data:{MIME_type};base64,{base64_data}
    • Exemple : data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (Ceci est fourni à titre indicatif uniquement. Vous devez transmettre la chaîne complète.)
    • Pour plus d'informations, consultez Méthodes d'entrée d'image.
parameters object (Facultatif)Paramètres de configuration du modèle.

Propriétés

bbox_list List[List[List[int]]] (Facultatif)Zone de cadre de délimitation pour l'édition interactive.
  • La longueur de la liste doit correspondre au nombre d'images d'entrée. Si une image ne nécessite aucune modification, transmettez une liste vide [] à la position correspondante.
  • Format des coordonnées : [x1, y1, x2, y2] (x supérieur gauche, y supérieur gauche, x inférieur droit, y inférieur droit). Utilisez les coordonnées absolues en pixels de l'image d'origine. La coordonnée supérieure gauche est (0, 0).
  • Une seule image peut contenir jusqu'à deux cadres de délimitation.
Exemple : Entrée de 3 images, où la deuxième image n'a pas de cadre de délimitation et la première en possède deux :
[
  [[0, 0, 12, 12], [25, 25, 100, 100]],  # Image 1 (2 boxes)
  [],                                    # Image 2 (no box)
  [[10, 10, 50, 50]]                     # Image 3 (1 box)
]
enable_sequential boolean (Facultatif)Contrôle le mode de génération d'images :
  • false (par défaut) : Mode de sortie par défaut.
  • true : Mode de sortie de jeu d'images.
size string (Facultatif)Résolution de l'image de sortie. Deux méthodes mutuellement exclusives sont prises en charge :Modèle : wan2.7-image-pro
  • Méthode 1 : Spécifier la résolution de l'image de sortie (Recommandé)
    • Prend en charge les spécifications 1K, 2K (par défaut) et 4K.
    • Champ d'application :
      • Texte-vers-image (aucune image en entrée, hors génération de jeux d'images) : Prend en charge 1K, 2K et 4K.
      • Autres scénarios : Prend en charge 1K et 2K.
    • Total de pixels pour chaque spécification : 1K : 1024×1024, 2K : 2048×2048, 4K : 4096×4096
    • Rapport d'aspect de l'image :
      • Lorsqu'une image est fournie en entrée : Le rapport d'aspect de sortie correspond à celui de l'image d'entrée (la dernière si plusieurs images sont fournies) et est mis à l'échelle selon la résolution sélectionnée.
      • En l'absence d'image en entrée : La sortie est une image carrée.
  • Méthode 2 : Spécifier la largeur et la hauteur en pixels pour l'image générée
    • Texte-vers-image : Le total de pixels est compris entre 768×768 et 4096×4096. Le rapport d'aspect se situe entre 1:8 et 8:1.
    • Autres scénarios : Le total de pixels est compris entre 768×768 et 2048×2048. Le rapport d'aspect se situe entre 1:8 et 8:1.
Modèle : wan2.7-image
  • Méthode 1 : Spécifier la résolution de l'image de sortie (Recommandé)
    • Prend en charge les spécifications 1K et 2K (par défaut). La 4K n'est pas prise en charge.
  • Méthode 2 : Spécifier la largeur et la hauteur en pixels pour l'image générée
    • Dans tous les scénarios, le total de pixels est compris entre 768×768 et 2048×2048. Le rapport d'aspect se situe entre 1:8 et 8:1.
Les valeurs de pixels de l'image de sortie peuvent présenter de légères différences par rapport aux valeurs spécifiées.
n int (Facultatif)
Le paramètre n affecte directement le coût : prix unitaire × nombre d'images générées avec succès. Consultez la tarification du modèle avant d'effectuer l'appel.
  • Lorsque le mode jeu d'images est désactivé, cette valeur représente le nombre d'images à générer. La plage s'étend de 1 à 4. La valeur par défaut est 1.
  • Lorsque le mode jeu d'images est activé, cette valeur représente le nombre maximal d'images à générer. La plage s'étend de 1 à 12. La valeur par défaut est 12. Le nombre réel est déterminé par le modèle et ne dépassera pas n.
thinking_mode boolean (Facultatif)Active le mode réflexion. La valeur par défaut est true. Ce paramètre n'est effectif que lorsque le mode jeu d'images est désactivé et qu'aucune image n'est fournie en entrée. Lorsqu'il est activé, le modèle améliore ses capacités d'inférence pour optimiser la qualité de sortie, ce qui augmente toutefois le temps de génération.color_palette array (Facultatif)Thème de couleur personnalisé. Tableau d'objets comprenant chacun une couleur hexadécimale et un ratio. Doit inclure de 3 à 10 couleurs. 8 couleurs sont recommandées.Cette option n'est disponible que lorsque le mode jeu d'images est désactivé (enable_sequential=false).

Propriétés

hex string (Obligatoire)Valeur de couleur au format hexadécimal (HEX).ratio string (Obligatoire)Pourcentage de la couleur. Doit être précis à deux décimales près (par exemple "25.00%"). La somme de toutes les valeurs de ratio doit être égale à 100,00 %.
"color_palette": [
    {
        "hex": "#C2D1E6",
        "ratio": "23.51%"
    },
    {
        "hex": "#CDD8E9",
        "ratio": "20.13%"
    },
    {
        "hex": "#B5C8DB",
        "ratio": "15.88%"
    },
    {
        "hex": "#C0B5B4",
        "ratio": "13.27%"
    },
    {
        "hex": "#DAE0EC",
        "ratio": "10.11%"
    },
    {
        "hex": "#636574",
        "ratio": "8.93%"
    },
    {
        "hex": "#CACAD2",
        "ratio": "5.55%"
    },
    {
        "hex": "#CBD4E4",
        "ratio": "2.62%"
    }
]
watermark bool (Facultatif)Ajoute un filigrane dans le coin inférieur droit de l'image avec le texte fixe « AI Generated ».
  • false (par défaut)
  • true
seed integer (facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647].L'utilisation de la même seed produit des sorties similaires. En cas d'omission, 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 réponse

  • Réponse réussie
  • Réponse d'erreur
Enregistrez le task_id afin d'interroger ultérieurement l'état et le résultat de la tâche.
{
        "output": {
            "task_status": "PENDING",
            "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
        },
        "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
    }
output objectInformations de sortie de la tâche.

Propriétés

task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.

Valeurs d'énumération

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN : La tâche n'existe pas ou son état est inconnu.
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage.
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur.

Étape 2 : Interroger le résultat par ID de tâche

  • Singapore
  • Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

Paramètres de la requête

  • Interrogation du résultat de la tâche
Remplacez {task_id} par la valeur task_id retournée lors de l'appel API précédent. La valeur task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY"
Headers
Authorization string (Required)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx.
Path parameters
task_id string (Required)Identifiant de la tâche.

Paramètres de la réponse

  • Exécution réussie de la tâche
  • Échec de l'exécution de la tâche
Les données de la tâche (statut et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement supprimées. Enregistrez les images générées sans tarder.
{
    "request_id": "810fa5f5-334c-91f3-aaa4-ed89cf0caxxx",
    "output": {
        "task_id": "a81ee7cb-014c-473d-b842-76e98311cxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-03-26 17:16:01.663",
        "scheduled_time": "2026-03-26 17:16:01.716",
        "end_time": "2026-03-26 17:16:22.961",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "size": "2976*1408",
        "total_tokens": 11017,
        "image_count": 1,
        "output_tokens": 2,
        "input_tokens": 11015
    }
}
output objectInformations de sortie de la tâche.

Properties

task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.

Enumeration values

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN : la tâche n'existe pas ou son statut est inconnu.
Transitions d'état lors de l'interrogation :
  • PENDING → RUNNING → SUCCEEDED ou FAILED.
  • La première interrogation retourne généralement le statut PENDING ou RUNNING.
  • Lorsque le statut passe à SUCCEEDED, la réponse contient l'URL de l'image générée.
  • Si le statut est FAILED, examinez le message d'erreur et relancez la tâche.
submit_time stringHeure de soumission de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.finished booleanIndique si la tâche est terminée. Valeur par défaut : false.choices arrayContenu de sortie généré par le modèle.

Properties

finish_reason stringRaison de l'arrêt de la tâche. La valeur stop signale une fin normale.message objectMessage retourné par le modèle.

Properties

role stringRôle du message. Toujours assistant.content array

Properties

type stringValeurs possibles : text, image.text stringTexte généré.image stringURL de l'image générée. Format : PNG.Ce lien expire au bout de 24 heures. Téléchargez l'image rapidement.
usage objectStatistiques d'utilisation de la requête. Seuls les résultats réussis sont comptabilisés.

Properties

image_count integerNombre d'images générées.size stringRésolution de l'image générée. Exemple : 1376*768.input_tokens integerNombre de tokens d'entrée (non facturés). La facturation repose sur le nombre d'images.output_tokens integerNombre de tokens de sortie (non facturés). La facturation repose sur le nombre d'images.total_tokens integerNombre total de tokens (non facturés). La facturation repose sur le nombre d'images.
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage.
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur.
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur.

Python SDK

Les noms des paramètres du SDK correspondent en grande partie à ceux de l'API HTTP. Les tâches de génération d'images pouvant prendre du temps, le SDK encapsule le workflow asynchrone HTTP. Les appels synchrones et asynchrones sont tous deux pris en charge.
La durée d'une tâche dépend de la longueur de la file d'attente et de l'état du service.
Assurez-vous d'utiliser le SDK Python DashScope version 1.25.15 ou ultérieure. Pour effectuer la mise à jour, consultez Installer le SDK.
Le paramètre base_url et la clé API dépendent de la région. L'exemple suivant utilise la région Singapore :
  • China (Beijing)
  • Singapore
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Singapore
  • China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Modification d'images

  • Synchronous call
  • Asynchronous call
Exemple de requête
import os
import base64
import mimetypes
import urllib.request
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# The following base_url is for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. The base_url varies by region.
dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"

# If you have not configured environment variables, replace the following line with your Model Studio API key: api_key="sk-xxx"
# The API key varies by region. To obtain an API key, visit: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

# --- Base64 encoding function ---
# The Base64 encoding format is data:{MIME_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("Unsupported or unrecognized image format")
    with open(file_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
    return f"data:{mime_type};base64,{encoded_string}"

"""
Image input methods:
The following are three methods for image input. You need to choose only one.
1. Use a public URL: This method is suitable for publicly accessible images.
2. Use a local file: This method is suitable for local development and testing.
3. Use Base64 encoding: This method is suitable for private images or scenarios that require encrypted transmission.
"""
# [Method 1] Use a public image URL
image_1 = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/pjeqdf/car.webp"
image_2 = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/xsunlm/paint.webp"

# [Method 2] Use a local file (supports absolute and relative paths)
# image_1 = "file:///path/to/your/car.png"
# image_2 = "file:///path/to/your/paint.png"

# [Method 3] Use a Base64-encoded image
# image_1 = encode_file("/path/to/your/car.png")
# image_2 = encode_file("/path/to/your/paint.png")

message = Message(
    role="user",
    content=[
        {"text": "Spray the graffiti from image 2 onto the car in image 1"},
        {"image": image_1},
        {"image": image_2},
    ],
)
print("----sync call, please wait a moment----")
rsp = ImageGeneration.call(
    model="wan2.7-image-pro",
    api_key=api_key,
    messages=[message],
    watermark=False,
    n=1,
    size="2K",  # wan2.7-image-pro supports 4K resolution only for text-to-image generation. Image editing and multi-image generation support up to 2K resolution.
)

# Extract the result image URL and save the image to a local file.
if rsp.status_code == 200:
    for i, choice in enumerate(rsp.output.choices):
        for j, content in enumerate(choice["message"]["content"]):
            if content.get("type") == "image":
                image_url = content["image"]
                file_name = f"output_{i}_{j}.png"
                # The result URL is valid for 24 hours. Please download it promptly.
                urllib.request.urlretrieve(image_url, file_name)
                print(f"Image saved to {file_name}")
else:
    print(f"Failed: status_code={rsp.status_code}, message={rsp.message}")
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image sans tarder.
{
    "status_code": 200,
    "request_id": "81d868c6-6ce1-92d8-a90d-d2ee71xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 18790,
        "output_tokens": 2,
        "characters": 0,
        "image_count": 1,
        "size": "2985*1405",
        "total_tokens": 18792
    }
}

Génération de séquences d'images

  • Appel synchrone
  • Appel asynchrone
Exemple de requête
import os
import base64
import mimetypes
import urllib.request
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# The following base_url is for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. The base_url varies by region.
dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"

# If you have not configured the environment variable, replace the following line with your Model Studio API key: api_key="sk-xxx"
# The API key varies by region. To obtain an API key, visit: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

# --- Base64 encoding function ---
# The Base64 encoding format is data:{MIME_type};base64,{base64_data}
def encode_file(file_path):
    mime_type, _ = mimetypes.guess_type(file_path)
    if not mime_type or not mime_type.startswith("image/"):
        raise ValueError("Unsupported or unrecognized image format")
    with open(file_path, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("utf-8")
    return f"data:{mime_type};base64,{encoded_string}"

"""
Description of image input methods (for image-to-image sequence generation):
Choose one of the following three image input methods:
1. Use a public URL - Suitable for publicly accessible images.
2. Use a local file - Suitable for local development and testing.
3. Use Base64 encoding - Suitable for private images or scenarios that require encrypted transmission.
"""
# [Method 1] Use a public image URL
# image_1 = "https://img.alicdn.com/imgextra/i4/O1CN01IM44WN23dq5uY1yla_!!6000000007279-49-tps-1024-1024.webp"

# [Method 2] Use a local file (supports both absolute and relative paths)
# image_1 = "file:///path/to/your/image.png"

# [Method 3] Use a Base64-encoded image
# image_1 = encode_file("/path/to/your/image.png")

message = Message(
    role="user",
    content=[
        {
            "text": "A cinematic image sequence featuring the same stray orange cat, whose features must be consistent across all images. First image: In spring, the orange cat weaves through blooming cherry blossom trees. Second image: In summer, the orange cat cools off in the shade of a tree on an old street. Third image: In autumn, the orange cat walks on a carpet of golden fallen leaves. Fourth image: In winter, the orange cat leaves footprints as it walks on the snow."
        }
        # For image-to-image sequence generation: Uncomment the following lines and comment out the plain text above.
        # {"text": "Generate a four-seasons image sequence based on the style of the reference image"},
        # {"image": image_1}
    ],
)

print("----sync call, please wait a moment----")
rsp = ImageGeneration.call(
    model="wan2.7-image-pro",
    api_key=api_key,
    messages=[message],
    enable_sequential=True,
    n=4,
    size="2K",  # wan2.7-image-pro supports 4K resolution only in text-to-image scenarios. Image editing and image sequence generation support a maximum resolution of 2K.
)

# Extract the resulting image URLs and save the images locally.
if rsp.status_code == 200:
    for i, choice in enumerate(rsp.output.choices):
        for j, content in enumerate(choice["message"]["content"]):
            if content.get("type") == "image":
                image_url = content["image"]
                file_name = f"output_{i}_{j}.png"
                # The result URL is valid for 24 hours. Download the image promptly.
                urllib.request.urlretrieve(image_url, file_name)
                print(f"Image saved to {file_name}")
else:
    print(f"Failed: status_code={rsp.status_code}, message={rsp.message}")
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image sans tarder.
{
    "status_code": 200,
    "request_id": "56e318fd-ed60-99e8-8ca1-cdef25ca4xxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 720,
        "output_tokens": 11,
        "characters": 0,
        "image_count": 4,
        "size": "2048*2048",
        "total_tokens": 731
    }
}

Java SDK

Les noms des paramètres du SDK correspondent en grande partie à ceux de l'API HTTP. Les tâches de génération d'images pouvant prendre du temps, le SDK encapsule le workflow asynchrone HTTP. Les appels synchrones et asynchrones sont tous deux pris en charge.
Assurez-vous que votre version du DashScope Java SDK est 2.22.13 ou ultérieure.
  • Chine (Pékin)
  • Singapour
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Singapour
  • Chine (Pékin)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Modification d'images

  • Appel synchrone
  • Appel asynchrone
Exemple de requête
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.util.Arrays;
import java.util.Base64;
import java.util.Collections;
import java.util.List;
import java.util.Map;

/**
 * wan2.7-image-pro Image Editing - Synchronous Call Example
 */
public class Main {

    static {
        // The following URL is for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. The base_url varies by region.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If you have not configured an environment variable, replace the following line with your Model Studio API key: apiKey="sk-xxx"
    // The API key varies by region. To obtain an API key, visit https://www.alibabacloud.com/help/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    // --- Base64 encoding function ---
    // Base64 encoding format: data:{MIME_type};base64,{base64_data}
    public static String encodeFile(String filePath) throws IOException {
        byte[] fileContent = Files.readAllBytes(Paths.get(filePath));
        String base64String = Base64.getEncoder().encodeToString(fileContent);
        String mimeType = Files.probeContentType(Paths.get(filePath));
        return "data:" + mimeType + ";base64," + base64String;
    }

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException, IOException {
        /*
         * Description of image input methods:
         * Three image input methods are provided below. Select one.
         * 1. Use a public URL: Suitable for publicly accessible images.
         * 2. Use a local file: Suitable for local development and testing.
         * 3. Use Base64 encoding: Suitable for private images or scenarios that require encrypted transmission.
         */
        // Method 1: Use a public image URL.
        String image1 = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/pjeqdf/car.webp";
        String image2 = "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251229/xsunlm/paint.webp";

        // Method 2: Use a local file. Both absolute and relative paths are supported.
        // Format: file:// + file path
        // String image1 = "file:///path/to/your/car.png";
        // String image2 = "file:///path/to/your/paint.png";

        // Method 3: Use a Base64-encoded image.
        // String image1 = encodeFile("/path/to/your/car.png");
        // String image2 = encodeFile("/path/to/your/paint.png");

        // Build a multi-image input message.
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // Multi-image input is supported. You can provide multiple reference images.
                        Collections.singletonMap("text", "Spray the graffiti from image 2 onto the car in image 1"),
                        Collections.singletonMap("image", image1),
                        Collections.singletonMap("image", image2)
                )).build();

        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.7-image-pro")
                .messages(Collections.singletonList(message))
                .n(1)
                .size("2K") // For wan2.7-image-pro, only the text-to-image generation scenario supports 4K resolution. Image editing and collage generation support a maximum resolution of 2K.
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---sync call for image editing, please wait a moment----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        // Extract the result image URL and save it to a local file.
        for (int i = 0; i < result.getOutput().getChoices().size(); i++) {
            List<Map<String, Object>> contents = result.getOutput().getChoices().get(i)
                    .getMessage().getContent();
            for (int j = 0; j < contents.size(); j++) {
                if ("image".equals(contents.get(j).get("type"))) {
                    String imageUrl = (String) contents.get(j).get("image");
                    String fileName = "output_" + i + "_" + j + ".png";
                    // The result URL is valid for 24 hours. Download the image in a timely manner.
                    try (InputStream in = new URL(imageUrl).openStream()) {
                        Files.copy(in, Paths.get(fileName), StandardCopyOption.REPLACE_EXISTING);
                    }
                    System.out.println("Image saved to " + fileName);
                }
            }
        }
    }

    public static void main(String[] args) throws ApiException, NoApiKeyException, UploadFileException, IOException {
        basicCall();
    }
}
Exemple de réponse
L'URL est valide pendant 24 heures. Enregistrez-la sans tarder.
{
    "requestId": "1bf6173a-e8de-9f75-94d3-5e618f875xxx",
    "usage": {
        "input_tokens": 18790,
        "output_tokens": 2,
        "total_tokens": 18792,
        "image_count": 1,
        "size": "2985*1405"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Génération de séries d'images

  • Appel synchrone
  • Appel asynchrone
Exemple de requête
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.util.Arrays;
import java.util.Base64;
import java.util.Collections;
import java.util.List;
import java.util.Map;

/**
 * An example of using wan2.7-image-pro for image series generation through synchronous calls in the Singapore region.
 */
public class Main {

    static {
        // The following URL is for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. The base_url varies by region.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If you have not configured the environment variable, replace the following line with your Model Studio API key: apiKey="sk-xxx"
    // API keys vary by region. To obtain an API key, visit: https://www.alibabacloud.com/help/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    // --- Base64 encoding function ---
    // The format for Base64 encoding is data:{MIME_type};base64,{base64_data}
    public static String encodeFile(String filePath) throws IOException {
        byte[] fileContent = Files.readAllBytes(Paths.get(filePath));
        String base64String = Base64.getEncoder().encodeToString(fileContent);
        String mimeType = Files.probeContentType(Paths.get(filePath));
        return "data:" + mimeType + ";base64," + base64String;
    }

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException, IOException {
        /*
         * Image input methods (for image-to-image series generation):
         * Three image input methods are provided below. Choose one.
         * 1. Public URL: Suitable for images that are already publicly accessible.
         * 2. Local file: Suitable for local development and testing.
         * 3. Base64 encoding: Suitable for private images or scenarios that require encrypted transmission.
         */
        // Method 1: Use a public image URL
        // String image1 = "https://img.alicdn.com/imgextra/i4/O1CN01IM44WN23dq5uY1yla_!!6000000007279-49-tps-1024-1024.webp";

        // Method 2: Use a local file (supports both absolute and relative paths)
        // Format: file:// + file path
        // String image1 = "file:///path/to/your/image.png";

        // Method 3: Use a Base64-encoded image
        // String image1 = encodeFile("/path/to/your/image.png");

        // Build the text input message. This supports both text-to-image and image-to-image series generation. This example demonstrates text-to-image series generation.
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "A cinematic image series documenting the same stray orange cat, whose features must remain consistent. First image: In spring, the cat weaves through blooming cherry blossom trees. Second image: In summer, the cat cools off in the shade on an old street. Third image: In autumn, the cat walks on a carpet of golden fallen leaves. Fourth image: In winter, the cat leaves footprints in the snow.")
                )).build();
        // For image-to-image series generation, uncomment the following code and comment out the plain text message builder above.
        // ImageGenerationMessage message = ImageGenerationMessage.builder()
        //         .role("user")
        //         .content(Arrays.asList(
        //                 Collections.singletonMap("text", "Generate a four-season image series based on the style of the reference image."),
        //                 Collections.singletonMap("image", image1)
        //         )).build();

        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.7-image-pro")
                .messages(Collections.singletonList(message))
                .enableSequential(true)
                .n(4)
                .size("2K") // The wan2.7-image-pro model supports 4K resolution only for text-to-image generation. Image editing and image series generation support a maximum resolution of 2K.
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("----sync call, please wait a moment----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        // Extract the resulting image URLs and save them to a local directory.
        for (int i = 0; i < result.getOutput().getChoices().size(); i++) {
            List<Map<String, Object>> contents = result.getOutput().getChoices().get(i)
                    .getMessage().getContent();
            for (int j = 0; j < contents.size(); j++) {
                if ("image".equals(contents.get(j).get("type"))) {
                    String imageUrl = (String) contents.get(j).get("image");
                    String fileName = "output_" + i + "_" + j + ".png";
                    // The resulting URL is valid for 24 hours. Be sure to download it promptly.
                    try (InputStream in = new URL(imageUrl).openStream()) {
                        Files.copy(in, Paths.get(fileName), StandardCopyOption.REPLACE_EXISTING);
                    }
                    System.out.println("Image saved to " + fileName);
                }
            }
        }
    }

    public static void main(String[] args) throws ApiException, NoApiKeyException, UploadFileException, IOException {
        basicCall();
    }
}
Exemple de réponse
L'URL reste valide pendant 24 heures. Pensez à la sauvegarder rapidement.
{
    "requestId": "4678c314-b37a-91c9-a2ae-2d3cd54bbxxx",
    "usage": {
        "input_tokens": 720,
        "output_tokens": 11,
        "total_tokens": 731,
        "image_count": 4,
        "size": "2048*2048"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        },
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Facturation et limitations de débit

  • Pour consulter le quota gratuit et le prix unitaire du modèle, reportez-vous à la rubrique Tarification des modèles.
  • Concernant les limites de débit applicables au modèle, consultez la section Wanxiang.
  • Détails de la facturation : la facturation repose sur le nombre d'images générées avec succès. Les appels échoués ainsi que les erreurs de traitement n'entraînent aucun frais et ne consomment pas votre quota gratuit pour les nouveaux utilisateurs.

Codes d'erreur

Si l'appel au modèle échoue et renvoie un message d'erreur, consultez la rubrique Codes d'erreur pour obtenir des instructions de résolution.