Le modèle Wan text-to-image génère des images à partir de requêtes textuelles et prend en charge les styles artistiques ainsi que les effets photographiques réalistes.
Prérequis
Avant d'effectuer un appel, obtenez une clé API et exportez la clé API en tant que variable d'environnement. Pour effectuer des appels à l'aide du SDK, installez le SDK DashScope.
Appel synchrone HTTP (wan2.6)
Récupérez le résultat en une seule requête. Cette méthode est recommandée pour la plupart des cas d'usage.
- Singapore
- US (Virginia)
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationLors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Le périmètre de déploiement mondial (région de Francfort) prend uniquement en charge les appels asynchrones .
Paramètres de la requête |
|
En-têtes de la requête | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Exemple : wan2.6-t2i.Pour les modèles wan2.5 et antérieurs, consultez la section Appel asynchrone HTTP pour les appels HTTP. | |
input object (Obligatoire)Objet d'entrée.
Propriétés messages array (Obligatoire)Messages de la requête. Actuellement, seules les conversations à tour unique sont prises en charge : transmettez un ensemble de paramètres role et content.
Propriétés role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau du contenu du message.
Propriétés text string(Obligatoire)Requête positive décrivant le contenu, le style et la composition souhaités pour l'image générée.Prend en charge le chinois et l'anglais, avec une longueur maximale de 2 100 caractères. Chaque caractère chinois, lettre, chiffre ou symbole compte pour un caractère. Les caractères excédentaires sont automatiquement tronqués.Exemple : Un chat orange assis, heureux, vif et mignon, réaliste et précis.Remarque : Une seule entrée de texte est prise en charge. Une erreur survient si vous ne fournissez aucune entrée de texte ou si vous en fournissez plusieurs. | |
parameters object (Facultatif)Paramètres de génération d'image.
Propriétés negative_prompt string (facultatif)Requête négative décrivant ce que vous ne souhaitez pas voir apparaître dans l'image.Prend en charge le chinois et l'anglais. La longueur maximale est de 500 caractères. Les caractères excédentaires sont tronqués automatiquement.Exemple : Faible résolution, basse qualité, membres déformés, doigts malformés, couleurs sursaturées, aspect cireux, absence de détails faciaux, surfaces trop lisses, apparence générée par IA. Composition chaotique. Texte flou ou déformé.size string (Facultatif)Résolution de l'image de sortie, au format width*height.
Résolutions recommandées pour les rapports d'aspect courants
integer (Facultatif)Nombre d'images à générer. La valeur doit être un entier compris entre 1 et 4. La valeur par défaut est 4.La facturation est basée sur le nombre d'images générées. Définissez cette valeur à 1 pour les tests.prompt_extend bool (Facultatif)Active la réécriture de la requête. Un LLM optimise la requête positive pour améliorer les résultats, ce qui est particulièrement utile pour les requêtes courtes. Ajoute 3 à 4 secondes au temps de traitement.
bool (Facultatif)Ajoute un filigrane « AI Generated » dans le coin inférieur droit de l'image.
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'image 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 de la tâche et URL des images) ne sont conservées que pendant 24 heures, puis automatiquement purgées. Enregistrez rapidement les images générées. |
output objectObjet de sortie.
Propriétés choices arrayContenu de sortie généré par le modèle.
Propriétés finish_reason stringRaison de l'arrêt de la tâche. stop indique une fin normale.message objectMessage renvoyé par le modèle.
Propriétés role stringRôle du message, fixé à assistant.content array
Propriétés image stringURL de l'image générée au format PNG. Valide pendant 24 heures. Téléchargez et enregistrez l'image rapidement.type stringType de sortie, fixé à image.booleanIndique si la tâche est terminée.
| |
usage objectStatistiques d'utilisation pour 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 : 1280*1280.input_tokens integerNombre de tokens d'entrée. Pour le text-to-image, la facturation est basée sur le nombre d'images ; cette valeur est donc fixée à 0.output_tokens integerNombre de tokens de sortie. Pour le text-to-image, la facturation est basée sur le nombre d'images ; cette valeur est donc fixée à 0.total_tokens integerNombre total de tokens. Pour le text-to-image, la facturation est basée sur le nombre d'images ; cette valeur est donc fixée à 0. | |
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 ayant échoué. Consultez la section Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez la section Codes d'erreur. |
HTTP asynchrone (wan2.6)
Le flux de tâche comprend deux étapes principales : Créer la tâche -> Interroger le résultat. Le processus est le suivant :
Étape 1 : Créer une tâche et obtenir l'ID de tâche
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationLors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Ne créez pas de tâches en double. Utilisez plutôt l'interrogation pour récupérer le résultat. - Pour un guide destiné aux débutants, consultez la rubrique Appeler des API avec Postman ou cURL.
Paramètres de requête |
|
En-têtes de requête | |
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. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Exemple : wan2.6-t2i.Pour les modèles wan2.5 et antérieurs, consultez la rubrique Appel HTTP asynchrone. | |
input object (Obligatoire)Objet d'entrée.
Propriétés messages array (Obligatoire)Messages de la requête. Actuellement, seules les conversations à tour unique sont prises en charge : transmettez un seul ensemble de paramètres role et content.
Propriétés role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau du contenu du message.
Propriétés text string(Obligatoire)Prompt positif décrivant le contenu, le style et la composition souhaités pour l'image générée.Prend en charge le chinois et l'anglais, avec une longueur maximale de 2 100 caractères. Chaque caractère chinois, lettre, chiffre ou symbole compte pour un caractère. Les caractères excédentaires sont automatiquement tronqués.Exemple : A flower shop with exquisite windows, a beautiful wooden door, and flowers on display.Remarque : Une seule entrée texte est prise en charge. Une erreur survient si vous ne fournissez aucune entrée texte ou si vous en fournissez plusieurs. | |
parameters object (Facultatif)Paramètres de génération d'image.
Propriétés negative_prompt string (facultatif)Prompt négatif décrivant les éléments à exclure de l'image.Prend en charge le chinois et l'anglais. Longueur maximale de 500 caractères. Les caractères excédentaires sont tronqués automatiquement.Exemple : Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-like appearance, no facial details, overly smooth surfaces, AI-generated look. Chaotic composition. Blurry or distorted text.size string (Facultatif)Résolution de l'image de sortie, au format width*height.
Résolutions recommandées pour les rapports d'aspect courants
integer (Facultatif)Nombre d'images à générer. La valeur doit être un entier compris entre 1 et 4. La valeur par défaut est 4.La facturation dépend du nombre d'images générées. Définissez cette valeur à 1 pour les tests.prompt_extend bool (Facultatif)Active la réécriture du prompt. Un LLM optimise le prompt positif afin d'améliorer les résultats, ce qui s'avère particulièrement utile pour les prompts courts. Ajoute 3 à 4 secondes au temps de traitement.
bool (Facultatif)Ajoute un filigrane « AI Generated » dans le coin inférieur droit de l'image.
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'image est probabiliste. Même avec la même seed, les résultats peuvent varier. |
Paramètres de réponse |
Conservez le task_id pour interroger l'état et le résultat de la tâche. |
output objectObjet de sortie.
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
| |
request_id stringIdentifiant unique de la requête 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. |
Étape 2 : Interroger le résultat par ID de tâche
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Recommandation d'interrogation : La génération d'image prend du temps. Mettez en place un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 10 secondes.
- Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Après le succès d'une tâche, une URL d'image valide pendant 24 heures est retournée. Téléchargez et enregistrez l'image dans un stockage permanent, tel que OSS.
Paramètres de requête |
Remplacez {task_id} par la valeur task_id retournée par l'appel API précédent. Le task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail. |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin URL | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de réponse |
Les données de la tâche (état et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement purgées. Enregistrez rapidement les images générées. |
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
stringHeure de soumission de la tâche. L'heure est au format 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 au format 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 au format UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.finished booleanIndique si la tâche est terminée.
arrayContenu de sortie généré par le modèle.
Propriétés finish_reason stringRaison de l'arrêt de la tâche. stop indique une fin normale.message objectMessage retourné par le modèle.
Propriétés role stringRôle du message, fixé à assistant.content array
Propriétés image stringURL de l'image générée au format PNG.Le lien est valide pendant 24 heures. Vous devez télécharger et enregistrer l'image rapidement.type stringType de sortie, fixé à image. | |
usage objectStatistiques d'utilisation pour 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 : 1280*1280.input_tokens integerNombre de tokens d'entrée. Cette valeur est actuellement fixée à 0.output_tokens integerNombre de tokens de sortie. Cette valeur est actuellement fixée à 0.total_tokens integerNombre total de tokens. Cette valeur est actuellement fixée à 0. | |
request_id stringIdentifiant unique de la requête 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. |
HTTP asynchrone (modèles wan2.5 et antérieurs)
Les tâches de génération d'image à partir de texte nécessitant un temps de traitement important (généralement 1 à 2 minutes), cette API fonctionne de manière asynchrone. Le flux comprend deux étapes principales : Créer la tâche -> Interroger le résultat. Le processus est le suivant :
La durée de traitement dépend de la file d'attente des tâches et de l'état du service.
Étape 1 : Créer une tâche et obtenir l'ID de tâche
- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_idreste valide pendant 24 heures. Ne créez pas de tâches en double. Privilégiez plutôt l'interrogation périodique pour récupérer le résultat. - Pour un guide destiné aux débutants, consultez Appeler des API avec Postman ou cURL.
Paramètres de requête |
Les clés API diffèrent selon les régions de Singapour et de Pékin. Obtenir une clé API L'URL ci-dessous correspond à la région de Singapour. Si vous utilisez un modèle dans la région de Pékin, remplacez l'URL par : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesisRemplacez {WorkspaceId} par votre véritable ID d'espace de travail. |
En-têtes de requête | |
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. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Pour les modèles de génération d'image à partir de texte, consultez la Liste des modèles.Exemple : wan2.5-t2i-preview.Pour les appels HTTP vers le modèle wan2.6, reportez-vous à Appel synchrone HTTP et Appel asynchrone HTTP. | |
input object (Obligatoire)Objet d'entrée contenant le prompt.
Propriétés prompt string (Obligatoire)Prompt positif décrivant le contenu et le style souhaités pour l'image générée.Ce paramètre accepte le chinois et l'anglais. Chaque caractère chinois, lettre ou signe de ponctuation compte pour un caractère. Les caractères excédentaires sont automatiquement tronqués. La limite de longueur varie selon la version du modèle :
string (Facultatif)Prompt négatif spécifiant les éléments à exclure de l'image. Utilisez-le pour contraindre la sortie.Ce paramètre accepte le chinois et l'anglais, avec une longueur maximale de 500 caractères. Les caractères excédentaires sont automatiquement tronqués.Exemple : basse résolution, erreur, meilleure qualité, mauvaise qualité, mutilé, doigts supplémentaires, mauvaises proportions, etc. | |
parameters object (Facultatif)Paramètres de génération d'image.
Propriétés size string (Facultatif)Résolution de l'image de sortie, au format largeur*hauteur. La valeur par défaut et les contraintes varient selon la version du modèle :
Résolutions recommandées pour les rapports d'aspect courants Les résolutions suivantes s'appliquent au modèle wan2.5-t2i-preview :
integer (Facultatif)Nombre d'images à générer. La valeur doit être un entier compris entre 1 et 4. La valeur par défaut est 4. Définissez-la à 1 pour les tests.prompt_extend boolean (Facultatif)Active la réécriture du prompt. Un LLM reformule le prompt d'entrée afin d'améliorer les résultats, ce qui est particulièrement utile pour les prompts courts. Cette option augmente le temps de traitement.
boolean (Facultatif)Ajoute un filigrane « AI Generated » dans le coin inférieur droit de l'image.
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'image est probabiliste. Même avec la même seed, les résultats peuvent varier. |
Paramètres de réponse |
Conservez le task_id pour interroger l'état et le résultat de la tâche. |
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
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné 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
- China (Beijing)
- Singapore
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapore
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Recommandation d'interrogation : La génération d'image prend du temps. Mettez en place un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 10 secondes.
- Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Une fois la tâche réussie, une URL d'image valide pendant 24 heures est retournée. Téléchargez et enregistrez l'image dans un stockage permanent, tel qu'OSS.
Paramètres de requête |
Remplacez 86ecf553-d340-4e21-xxxxxxxxx par votre véritable task_id.Les clés API diffèrent selon les régions. Pour plus d'informations, consultez Obtenir une clé API. Si vous utilisez un modèle dans la région China (Beijing), remplacez |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin d'URL | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de réponse |
Les URL des images ne sont valides que pendant 24 heures, puis elles sont automatiquement purgées. Enregistrez les images générées sans tarder. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringStatut de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est en UTC+8 et le format est YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est en UTC+8 et le format est YYYY-MM-DD HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est en UTC+8 et le format est YYYY-MM-DD HH:mm:ss.SSS.results array of objectListe des résultats de la tâche. Elle comprend les URL des images, les prompts et les messages d'erreur pour les tâches ayant partiellement échoué.
Structure des données
Propriétés orig_prompt stringPrompt d'entrée original, correspondant au paramètre de requête prompt.actual_prompt stringPrompt optimisé utilisé lorsque la réécriture de prompt est activée. Non retourné si cette option est désactivée.url stringURL de l'image. Retournée uniquement lorsque task_status est SUCCEEDED. Le lien est valide pendant 24 heures et permet de télécharger l'image.code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur.objectStatistiques relatives au résultat de la tâche.
Propriétés TOTAL integerNombre total de tâches.SUCCEEDED integerNombre de tâches réussies.FAILED integerNombre de tâches ayant échoué.stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur. | |
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 avec succès. Facturation : Coût = Nombre d'images × Prix unitaire. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
SDK Python DashScope
Les noms des paramètres du SDK correspondent à ceux de l'API HTTP, avec des structures adaptées à Python.
Les tâches de génération d'image à partir de texte pouvant prendre un temps significatif, le SDK encapsule le processus d'appel asynchrone HTTP et prend en charge les appels synchrones et asynchrones.
Le temps de traitement dépend de la file d'attente des tâches et de l'état du service.
wan2.6
Le base_url et la clé API sont spécifiques à chaque région. L'exemple suivant illustre un appel dans la région Singapour :
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Le périmètre de déploiement mondial (région Francfort) ne prend en charge que les appels asynchrones.
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Vous devez télécharger l'image sans tarder.
Modèles wan2.5 et antérieurs
Le base_url et la clé API sont spécifiques à chaque région. L'exemple suivant illustre un appel dans la région Singapour :
- 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.- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Vous devez télécharger l'image sans tarder.
DashScope Java SDK
Les noms des paramètres du SDK correspondent à ceux de l'API HTTP, avec des structures adaptées pour Java.
Les tâches de génération d'image à partir de texte peuvent nécessiter un temps de traitement important. Le SDK encapsule le flux d'appel asynchrone HTTP et prend en charge les appels synchrones et asynchrones.
La durée de traitement dépend de la file d'attente des tâches et de l'état du service.
wan2.6
L'base_url et la clé API sont spécifiques à chaque région et ne sont pas interchangeables. Les exemples suivants montrent comment effectuer un appel dans la région de Singapour :
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Le périmètre de déploiement mondial (région de Francfort) prend uniquement en charge les appels asynchrones.
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL reste valide pendant 24 heures. Téléchargez l'image sans tarder.
Modèles wan2.5 et antérieurs
L'base_url et la clé API sont propres à chaque région et ne peuvent pas être interchangées. Les exemples suivants illustrent un appel dans la région de Singapour :
- 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.- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL reste valide pendant 24 heures. Téléchargez l'image sans tarder.
Limites
- Validité des données : L'identifiant de tâche
task_idet l'urlde l'image ne sont conservés que pendant 24 heures. Passé ce délai, toute interrogation ou tout téléchargement devient impossible. - 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 déclenche une erreurIPInfringementSuspectouDataInspectionFailed. Consultez la rubrique Codes d'erreur.
Facturation et limitation du débit
- Vérifiez les quotas gratuits et les tarifs directement dans la console.
- Concernant les limites de débit du modèle, reportez-vous à la section Série Wan.
- La facturation repose sur le nombre d'images générées avec succès. Les appels échoués n'entraînent aucun frais et n'entament pas le quota gratuit pour nouveaux utilisateurs.