Skip to main content

Wan -image-to-video-first and last frames API reference(2.2)

Le modèle Wan 2,2 génère une vidéo avec des transitions fluides à partir d'une première image , d'une dernière image et d'un prompt textuel .

Documents associés : Guide utilisateur

Remarques sur l'utilisation

Pour garantir le succès des appels API, votre modèle, votre URL d'endpoint et votre clé API doivent se trouver dans la même région. Les appels interrégionaux échoueront.
  • Sélectionner un modèle : confirmez la région où le modèle est disponible.
  • Sélectionner une URL : choisissez l'URL d'endpoint correspondant à votre région. Les URL HTTP et les URL du SDK DashScope sont toutes deux prises en charge.
  • Configurer votre clé API : sélectionnez une région, obtenez votre clé API, puis définissez-la comme variable d'environnement.
  • Installer le SDK : pour effectuer des appels API via le SDK, installez le SDK DashScope.
Les exemples de code de cette rubrique s'appliquent à la région Singapour.
Alibaba Cloud Model Studio a publié des domaines spécifiques aux espaces de travail pour les régions Chine (Pékin) et Singapour. Ces nouveaux domaines dédiés offrent des performances supérieures et une stabilité accrue pour les requêtes d'inférence. Nous vous recommandons de migrer vers ces nouveaux domaines :
  • Chine (Pékin) : de https://dashscope.aliyuncs.com vers https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapour : de https://dashscope-intl.aliyuncs.com vers https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} correspond à votre ID d'espace de travail, consultable sur la page Workspace Details dans la console Alibaba Cloud Model Studio. Le domaine existant reste pleinement fonctionnel.

Appel HTTP

Les tâches image-vers-vidéo étant des opérations longues (généralement de 1 à 5 minutes), l'API utilise un appel asynchrone. Le processus comprend deux étapes principales : créer une tâche, puis interroger régulièrement pour obtenir le résultat.

Étape 1 : Créer une tâche

  • Singapore
  • China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesisRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Une fois la tâche créée, utilisez le task_id retourné pour interroger le résultat. Ce task_id reste valide pendant 24 heures. Ne créez pas de tâches en double. Utilisez plutôt l'interrogation régulière 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 la requête

  • Première et dernière images
  • Prompt négatif
Génère une vidéo à partir d'une première image, d'une dernière image et d'un prompt.
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
        -H 'X-DashScope-Async: enable' \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H 'Content-Type: application/json' \
        -d '{
        "model": "wan2.2-kf2v-flash",
        "input": {
            "first_frame_url": "https://wanx.alicdn.com/material/20250318/first_frame.png",
            "last_frame_url": "https://wanx.alicdn.com/material/20250318/last_frame.png",
            "prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view."
        },
        "parameters": {
            "resolution": "480P",
            "prompt_extend": true
        }
    }'
En-têtes de la requête
Content-Type string (Required)Type de contenu de la requête. Doit être application/json.
Authorization string (Required)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.
X-DashScope-Async string (Required)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 retournée.
Corps de la requête
model string (Required)Nom du modèle. Exemple : wan2.2-kf2v-flash.Pour plus de détails, consultez la console Model Studio.
input object (Required)Contient les données d'entrée principales de la tâche, telles que le prompt.

Propriétés

prompt string (Optional)Prompt textuel. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères. Les caractères chinois et les lettres comptent chacun pour un seul caractère. Le texte dépassant cette limite est tronqué.En cas de changements significatifs de sujet ou de scène entre la première et la dernière image, nous vous recommandons de décrire le processus de transition, par exemple un mouvement de caméra (« la caméra se déplace vers la gauche ») ou un mouvement du sujet (« une personne court vers l'avant »).Exemple : « Un petit chat noir regarde le ciel avec curiosité. La caméra s'élève progressivement depuis le niveau des yeux et capture finalement son regard curieux selon une vue de dessus. »Pour obtenir des conseils sur la rédaction de prompts efficaces, consultez le guide des prompts pour le texte-vers-vidéo et l'image-vers-vidéo.negative_prompt string (Optional)Prompt négatif décrivant le contenu à exclure de la vidéo, ce qui permet de contraindre la sortie.Prend en charge le chinois et l'anglais. La longueur maximale est de 500 caractères. Le texte dépassant cette limite est tronqué.Exemple : « low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions ».first_frame_url string (Required)URL de la première image. Le rapport d'aspect de la vidéo de sortie correspondra à celui de cette première image.L'URL doit être une adresse accessible publiquement prenant en charge le protocole HTTP ou HTTPS.Exigences relatives à l'image :
  • Format : JPEG, JPG, PNG (canal alpha non pris en charge), BMP, WEBP.
  • Résolution : la largeur et la hauteur doivent être comprises entre 240 et 8 000 pixels.
  • Taille du fichier : 10 Mo maximum.
last_frame_url string (Required)URL de la dernière image.L'URL doit être une adresse accessible publiquement prenant en charge le protocole HTTP ou HTTPS.Exigences relatives à l'image :
  • Format : JPEG, JPG, PNG (canal alpha non pris en charge), BMP, WEBP.
  • Résolution : la largeur et la hauteur doivent être comprises entre 240 et 8 000 pixels. La résolution de la dernière image peut différer de celle de la première ; leurs résolutions ou rapports d'aspect n'ont pas besoin de correspondre.
  • Taille du fichier : 10 Mo maximum.
parameters object (Optional)Paramètres de traitement vidéo.

Propriétés

resolution string (Optional)
Le paramètre resolution influence directement le coût. Pour un même modèle, la hiérarchie des coûts est 1080P > 720P > 480P. Vérifiez les tarifs dans la console Model Studio avant d'effectuer un appel.
Résolution de la vidéo générée. Ce paramètre ajuste la définition (nombre total de pixels) sans modifier le rapport d'aspect.La valeur par défaut et les valeurs disponibles pour ce paramètre dépendent du modèle, comme décrit ci-dessous :
  • wan2.2-kf2v-flash : les valeurs possibles sont 480P, 720P et 1080P. La valeur par défaut est 720P.
  • wan2.1-kf2v-plus : la seule valeur possible est 720P. La valeur par défaut est 720P.
Exemple : 720Pduration integer (Optional)
Le paramètre duration influence directement le coût, facturé à la seconde. Vérifiez les tarifs dans la console Model Studio avant d'effectuer un appel.
Cette valeur est fixée à 5.prompt_extendbool (Optional)Indique s'il faut activer la réécriture du prompt. Lorsqu'elle est activée, un grand modèle de langage (LLM) réécrit intelligemment le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente la latence.
  • true : valeur par défaut. Active la réécriture du prompt.
  • false : désactive la réécriture du prompt.
Exemple : truewatermark bool (Optional)Indique s'il faut ajouter un filigrane portant la mention « AI-generated » dans le coin inférieur droit de la vidéo.
  • false : valeur par défaut. N'ajoute pas de filigrane.
  • true : ajoute un filigrane.
Exemple : falseseed integer (Optional)La graine de nombre aléatoire doit être un entier compris dans l'intervalle [0, 2147483647].Si elle n'est pas spécifiée, une graine aléatoire est générée. Une graine fixe améliore la reproductibilité.La génération du modèle étant probabiliste, une même graine ne garantit pas des résultats identiques.

Paramètres de la réponse

  • Réponse réussie
  • Réponse d'erreur
Enregistrez le 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"
    }
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. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.

Étape 2 : Interroger le résultat

  • Singapore
  • China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
  • Recommandation d'interrogation : la génération vidéo prend plusieurs minutes. Utilisez un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 15 secondes.
  • Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
  • Lien du résultat : après la réussite d'une tâche, une URL vidéo valide pendant 24 heures est retournée. Téléchargez et enregistrez la vidéo dans un stockage permanent, tel que OSS.
  • Validité du task_id : 24 heures. Passé ce délai, les requêtes retournent l'état de la tâche comme UNKNOWN.

Paramètres de la requête

  • Interroger le résultat de la tâche
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 Chine (Pékin), remplacez base_url par https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx, où {WorkspaceId} est votre véritable ID d'espace de travail.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY"
En-têtes de la requête
Authorization string (Required)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx.
Paramètres de chemin
task_id string (Required)ID de la tâche.

Paramètres de la réponse

  • Tâche réussie
  • Échec de la tâche
  • Requête de tâche expirée
Les URL vidéo ne sont valides que pendant 24 heures, puis automatiquement purgées. Enregistrez rapidement les vidéos générées.
{
    "request_id": "ec016349-6b14-9ad6-8009-xxxxxx",
    "output": {
        "task_id": "3f21a745-9f4b-4588-b643-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-04-18 10:36:58.394",
        "scheduled_time": "2025-04-18 10:37:13.802",
        "end_time": "2025-04-18 10:45:23.004",
        "video_url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?xxxxx",
        "orig_prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.",
        "actual_prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view. The cat's yellow eyes are bright and expressive, its fur is smooth, and its whiskers are clearly visible. The background is a simple light-colored wall, highlighting the cat's black silhouette. A close-up shot emphasizes the changes in the cat's expression and the details of its eyes."
    },
    "usage": {
        "video_duration": 5,
        "video_count": 1,
        "SR": 480
    }
}
outputobjectInformations 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.
Transitions d'état lors de l'interrogation :
  • PENDING → RUNNING → SUCCEEDED ou FAILED.
  • L'état initial de la requête est généralement PENDING ou RUNNING.
  • Lorsque l'état passe à SUCCEEDED, la réponse contient l'URL de la vidéo générée.
  • Si l'état est FAILED, vérifiez le message d'erreur et réessayez la tâche.
submit_time 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.video_url stringURL de la vidéo générée. Retournée uniquement lorsque task_status est SUCCEEDED.Valide pendant 24 heures. La vidéo est au format MP4 avec un encodage H.264.orig_prompt stringPrompt d'entrée original, correspondant au paramètre de requête prompt.actual_prompt stringPrompt optimisé utilisé lorsque la réécriture du prompt est activée. Non retourné lorsqu'elle est désactivée.code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.
usage objectStatistiques d'utilisation de la tâche. Seules les tâches réussies sont facturées.

Propriétés

video_duration integerDurée de la vidéo générée en secondes, toujours égale à 5. Formule de facturation : Coût = Secondes vidéo × Prix unitaire.video_count integerNombre de vidéos générées. Cette valeur est fixée à 1.video_ratio stringCette valeur n'est actuellement retournée que par le modèle 2,1. Rapport d'aspect de la vidéo générée, fixé à standard.SR integerCette valeur n'est actuellement retournée que par le modèle 2,2. Niveau de résolution de la vidéo générée. Les valeurs possibles sont 480, 720 et 1080.
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage.

Appels via le SDK DashScope

Les noms de paramètres du SDK sont largement cohérents avec ceux de l'API HTTP, et la structure des paramètres suit les conventions de chaque langage de programmation. Les tâches image-vers-vidéo étant longues (généralement de 1 à 5 minutes), le SDK gère les appels HTTP asynchrones en interne, prenant en charge les méthodes d'appel synchrones et asynchrones.
Le temps de traitement réel dépend du nombre de tâches en file d'attente et des performances du service. Veuillez patienter.

Appels via le SDK Python

Avant d'exécuter le code suivant, assurez-vous que votre version du SDK Python DashScope est au moins2.0.1.Les versions antérieures peuvent déclencher des erreurs telles que « url error, please check url! ». Consultez Installer le SDK pour effectuer la mise à jour.
Définissez region en fonction de la région du modèle (transmis lors de la construction du Client ; la valeur de region varie selon la région) :
  • Singapore
  • Beijing
region="ap-southeast-1"Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.

Exemple de code

  • Synchronous call
  • Asynchronous call
Cet exemple illustre un appel synchrone avec deux méthodes de saisie d'image : une URL publique et un chemin de fichier local.
Exemple de requête
import os
import dashscope
from dashscope.v2 import DashScopeError

# Voici la configuration de la région de Singapour (ap-southeast-1). Remplacez {WorkspaceId} par l'ID de votre workspace. La valeur de region varie selon la région.
client = dashscope.Client(
    # Si la variable d'environnement n'est pas configurée, remplacez la ligne suivante par votre API Key de Model Studio : api_key="sk-xxx"
    # Les API Key sont spécifiques à chaque région. Pour obtenir une API Key, consultez https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

"""
Prérequis :
    dashscope python SDK >= 2.0.1
Installation/mise à niveau du SDK :
    pip install -U dashscope
"""

# ========== Méthodes d'entrée d'image (choisir une seule) ==========
# [Méthode 1] Utiliser une URL d'image publique
first_frame_url = "https://wanx.alicdn.com/material/20250318/first_frame.png"
last_frame_url = "https://wanx.alicdn.com/material/20250318/last_frame.png"

# [Méthode 2] Utiliser un chemin de fichier local (file:// + chemin du fichier)
# Avec un chemin absolu :
# first_frame_url = "file://" + "/path/to/your/first_frame.png"  # Linux/macOS
# last_frame_url = "file://" + "C:/path/to/your/last_frame.png"  # Windows
# Ou avec un chemin relatif :
# first_frame_url = "file://" + "./first_frame.png"              # Utilisez votre chemin réel.
# last_frame_url = "file://" + "./last_frame.png"                # Utilisez votre chemin réel.

def sample_sync_call_kf2v():
    print('please wait...')
    # generate est un appel en une étape (soumet la tâche et attend la fin) qui renvoie un Job terminé
    # first_frame_url et last_frame_url sont des champs de la section input, absents de la signature nommée ; ils sont transmis via extra_input
    try:
        job = client.videos.generate(model="wan2.2-kf2v-flash",
                                     prompt="Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.",
                                     extra_input={'first_frame_url': first_frame_url,
                                                  'last_frame_url': last_frame_url},
                                     resolution="720P",
                                     prompt_extend=True)
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"Code de statut HTTP: {e.status_code}")
        print(f"Code d'erreur: {e.code}")
        print(f"Message d'erreur: {e.message}")
        print("Consultez la documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_kf2v()
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Veuillez télécharger la vidéo dans ce délai.
{
    "status_code": 200,
    "request_id": "a37fafc3-907c-96f3-95a6-5b2a8268a3fd",
    "code": null,
    "message": "",
    "output": {
        "task_id": "4dba0092-da13-42b2-afb1-0f7b8a0f4643",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/xxx.mp4?xxxxx",
        "submit_time": "2025-05-23 15:50:12.404",
        "scheduled_time": "2025-05-23 15:50:12.443",
        "end_time": "2025-05-23 15:54:56.502",
        "orig_prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.",
        "actual_prompt": "Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view. The cat's yellow eyes are bright and expressive, its ears are pricked, and its whiskers are clearly visible. The background is a simple, light-colored wall that highlights the cat's black fur and focused expression. A close-up shot emphasizes the change in the cat's gaze and posture."
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}

Appels via le SDK Java

Avant d'exécuter le code suivant, assurez-vous que votre version du SDK Java DashScope est au moins la2.20.9.Les versions antérieures peuvent déclencher des erreurs telles que « url error, please check url! ». Consultez Installer le SDK pour effectuer la mise à jour.

Exemple de code

  • Synchronous call
  • Asynchronous call
Cet exemple illustre un appel synchrone avec deux méthodes de saisie d'image : URL publique et chemin de fichier local.
Exemple de requête
// Copyright (c) Alibaba, Inc. and its affiliates.

// DashScope SDK >= 2.20.1
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.HashMap;
import java.util.Map;

public class Kf2vSyncIntl {

    static {
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Get the DashScope API key (which is your Model Studio API key) from an environment variable.
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * Image input method (choose one):
     *
     * [Method 1] Public URL
     */
    static String firstFrameUrl = "https://wanx.alicdn.com/material/20250318/first_frame.png";
    static String lastFrameUrl = "https://wanx.alicdn.com/material/20250318/last_frame.png";

     /**
     * [Method 2] Local file path (file://+absolute path or file:///+absolute path)
     */
    // static String firstFrameUrl = "file://" + "/your/path/to/first_frame.png";  // Linux/macOS
    // static String lastFrameUrl = "file:///" + "C:/path/to/your/img.png";        // Windows

    public static void syncCall() {

        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);
        parameters.put("resolution", "720P");

        VideoSynthesis videoSynthesis = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.2-kf2v-flash")
                        .prompt("Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.")
                        .firstFrameUrl(firstFrameUrl)
                        .lastFrameUrl(lastFrameUrl)
                        .parameters(parameters)
                        .build();
        VideoSynthesisResult result = null;
        try {
            // Making a synchronous call. This may take a moment.
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}
Exemple de réponse
L'URL video_url est valide pendant 24 heures. Veuillez télécharger la vidéo dans ce délai.
{
    "request_id": "e6bb4517-c073-9c10-b748-dedb8c11bb41",
    "output": {
        "task_id": "984784fe-83c1-4fc4-88c7-52c2c1fa92a2",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/xxx.mp4?xxxxx"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}

Limites

  • Rétention des données : le task_id de la tâche et l'URL video_url de la vidéo sont conservés pendant 24 heures, après quoi ils ne peuvent plus être interrogés ni téléchargés.
  • Prise en charge audio : le service génère uniquement des vidéos muettes. Pour générer de l'audio, utilisez la synthèse vocale.
  • Modération de contenu : la modération de contenu examine tous les prompts d'entrée, les images et les vidéos de sortie. Si un contenu enfreint les politiques d'utilisation, le service retourne une erreur « IPInfringementSuspect » ou « DataInspectionFailed ». Pour plus de détails, consultez Codes d'erreur.

Codes d'erreur

En cas d'échec d'un appel de modèle, consultez Codes d'erreur pour le dépannage.

FAQ

Q : Comment générer un rapport d'aspect spécifique ?

R : Le rapport d'aspect de la vidéo de sortie dépend de la première image (first_frame_url). Cependant, un rapport exact (tel qu'un strict 3:4) ne peut être garanti et peut présenter de légères variations.
  • Pourquoi le rapport d'aspect varie-t-il ? Le modèle utilise le rapport d'aspect de l'image d'entrée comme référence et calcule la résolution valide la plus proche en fonction du nombre total de pixels du paramètre resolution sélectionné. Comme la largeur et la hauteur de la vidéo doivent être des multiples de 16, le modèle apporte des ajustements mineurs à la résolution finale.
    • Par exemple, si vous fournissez une image d'entrée de 750×1000 (rapport d'aspect de 3:4 ou 0,75) et définissez resolution sur « 720P » (visant environ 920 000 pixels), la sortie réelle pourrait être de 816×1104 (rapport d'aspect d'environ 0,739, avec près de 900 000 pixels).
  • Recommandations :
    • Image d'entrée : pour de meilleurs résultats, utilisez une première image correspondant à votre rapport d'aspect cible.
    • Post-traitement : si un rapport d'aspect strict est requis, utilisez un outil de montage vidéo pour recadrer la vidéo générée ou ajouter des bandes noires.

Q : Comment obtenir la liste d'autorisation de noms de domaine pour le stockage vidéo ?

R : Les vidéos générées par les modèles sont stockées dans OSS. L'API retourne 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 de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.