Skip to main content

Référence de l'API de génération Vidu-Image

Les modèles de génération d'images Vidu prennent en charge les tâches de texte vers image, d'édition d'image et d'image de référence vers image.

Aperçu du modèle

Modèle

Capacités

Modalité d'entrée

Spécifications de l'image de sortie

vidu/vidu-image_reference2image

Génération d'images de référence, texte vers image, édition d'images. Rendu précis du texte en chinois et en anglais, restauration au niveau du pixel des interfaces utilisateur/graphiques et des détails de conception. Idéal pour les affiches, les infographies, etc.

Texte, Image

Résolution : 1K, 2K, 4K

Nombre d'images : 1

Format d'image : PNG

Prérequis

  1. Activer le service : Accédez à la console Model Studio, recherchez « Vidu », trouvez la fiche modèle correspondante, et cliquez sur Activate Now pour confirmer l'activation et l'autorisation dans la fenêtre contextuelle.
  2. Configurer API Key : Sélectionner une région et Obtenir une clé API.

Appel HTTP

Les tâches de génération d'images prennent un certain temps et l'API utilise des appels asynchrones. Le processus comprend « Créer une tâche -> Interroger les résultats » deux étapes principales, comme suit :

Étape 1 : Soumettre la tâche de génération d'images

Région de Singapour : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation

Paramètres de la requête

En-têtes
Content-Type string (Obligatoire)Le type de contenu de la requête. Doit être application/json.Authorization string (Obligatoire)Authentifie la requête avec 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. Doit être enable.
Si cet en-tête de requête est manquant, 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 disponibles :
  • vidu/vidu-image_reference2image
input object (Obligatoire)Objet de paramètre d'entrée contenant les champs suivants :

Propriétés

messages array (Obligatoire)Liste des messages. Le serveur extrait le premier text non vide comme invite et extrait tous les champs image comme images de référence. Le tableau contient exactement un objet avec les propriétés role et content.

Propriétés

rolestring (Facultatif)Rôle du message. Valeur recommandée : user.contentarray (Obligatoire)Contenu du message, contenant des prompts textuels (text) et des images de référence facultatives (image, plusieurs prises en charge).

Propriétés

textstring(Conditionnellement obligatoire)Prompt positif décrivant le contenu, le style et la composition de l'image souhaités.Prend en charge le chinois et l'anglais. La longueur maximale est de 5,000 caractères, chaque caractère (chinois, lettre, chiffre ou symbole) comptant pour un.Exemple : Un chat orange assis avec une expression heureuse, vif et mignon, réaliste et précis.Remarque : Au moins un texte non vide est requis dans les messages.image string (Facultatif)URL d'une image de référence. Plusieurs images sont prises en charge. Tous les modèles prennent en charge jusqu'à 14 images de référence.Contraintes de l'image :
  • Formats : PNG, JPG, WEBP.
  • Rapport d'aspect : Entre 1:4 et 4:1.
  • Taille du fichier : La taille totale de toutes les images ne doit pas dépasser 50 Mo.
  • Quantité : Jusqu'à 14 images de référence.
parameters object (Facultatif)Paramètres de génération d'images.

Propriétés

size string (Facultatif)Taille de l'image au format width*height (par exemple, 2048*2048). La valeur par défaut est 1024*1024 si non spécifié.Consultez la section Tailles d'image prises en charge ci-dessous pour la liste des tailles prises en charge par modèle.n integer (Facultatif)Nombre d'images à générer. Actuellement, seule la valeur 1 est prise en charge. Toute autre valeur renverra une erreur de paramètre.seed integer (Facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647]. 0 signifie aléatoire.L'utilisation de la même seed produit des sorties similaires. Si omis, l'algorithme utilise une graine aléatoire.watermark bool (Facultatif)Indique s'il faut ajouter un filigrane.
  • false : Par défaut. Aucun filigrane.
  • true : Ajouter un filigrane.
  • Texte vers image
  • Image de référence vers image
Pris en charge par tous les modèles Vidu.
# Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "vidu/vidu-image_reference2image",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "text": "A flower shop with exquisite windows, a beautiful wooden door, displaying flowers"
                    }
                ]
            }
        ]
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1,
        "watermark": false
    }
}'

Paramètres de réponse

request_id stringIdentifiant de requête unique pour le suivi et le dépannage.code stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Voir Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les codes d'erreur.
  • Réponse réussie
  • Réponse d'erreur
Enregistrer l'task_id pour interroger 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"
}

Étape 2 : Interroger les résultats de la tâche

Région de Singapour : GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • Recommandation d'interrogation : La génération d'images prend du temps. Il est recommandé d'utiliser un mécanisme d'interrogation avec un intervalle de requête raisonnable (par exemple, 5 secondes) pour obtenir les résultats.
  • Flux d'état de la tâche : PENDING (en attente) → RUNNING (en cours) → SUCCEEDED (succès) / FAILED (échec).
  • Validité des liens d'image : Les liens de téléchargement des images générées sont valides pendant 24 heures. Veuillez télécharger et enregistrer les images rapidement.

Paramètres de la requête

En-têtes
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.task_id string (Obligatoire)L'ID de la tâche.
  • Interroger les résultats de la tâche
# Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
curl --location --request GET 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Paramètres de réponse

output objectInformations de sortie de la tâche.

Propriétés

task_id stringID de la tâche.choices arrayListe des candidats de sortie d'image, renvoyée uniquement lorsque task_status=SUCCEEDED.

Propriétés

finish_reason stringRaison de la fin. Généralement stop en cas de succès.message objectMessage renvoyé par le modèle.

Propriétés

rolestringRôle du message, fixé à assistant.contentarray

Propriétés

type stringType du contenu de sortie, fixé à image.image stringLien de téléchargement pour l'image générée au format PNG. Le lien est valide pendant 24 heures. Veuillez télécharger et enregistrer l'image rapidement.
finished boolIndique si la tâche est terminée, renvoyé uniquement lorsque task_status=SUCCEEDED.
usage objectInformations sur l'utilisation des ressources. Ne compte que les résultats réussis.

Propriétés

image_count integerNombre d'images générées.size stringRésolution de l'image générée au format width*height. Exemple : 2048*2048.SR stringNiveau de résolution de l'image générée. Exemple : 2K.
request_id stringIdentifiant de requête unique pour le suivi et le dépannage.code stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Voir Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez les codes d'erreur.
  • Tâche réussie
  • Échec de la tâche
{
    "request_id": "f584a817-6e00-9841-961a-49f7382a03d4",
    "output": {
        "task_id": "6404d4ec-4cdf-45b5-8d7d-3d429c6baed5",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-07-13 20:27:41.291",
        "scheduled_time": "2026-07-13 20:27:41.320",
        "end_time": "2026-07-13 20:28:39.767",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://example.com/generated-image.png",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "SR": "2K",
        "size": "2048*2048",
        "image_count": 1
    }
}

Codes d'erreur

Si l'appel du modèle échoue et renvoie un message d'erreur, consultez les codes d'erreur pour obtenir une solution.

Tailles d'image prises en charge

vidu-image

Résolution

Tailles prises en charge

1K

1024*1024, 720*1440, 1440*720, 1024*768, 768*1024, 1920*1088, 1088*1920, 1536*1024, 1024*1536, 1920*816, 816*1920

2K

2048*2048, 1088*2160, 2160*1088, 2736*2048, 2048*2736, 2560*1440, 1440*2560, 3072*2048, 2048*3072, 2560*1104, 1104*2560

4K

2880*2880, 1440*2880, 2880*1440, 3312*2480, 2480*3312, 3840*2160, 2160*3840, 3520*2352, 2352*3520, 3840*1648, 1648*3840