Créer une vidéo

Créez une tâche asynchrone à partir d’un prompt textuel et d’une image de référence facultative. Le Video ID renvoyé permet de consulter l’état et de télécharger le résultat.

POST/v1/videos

Créez une tâche asynchrone de génération de vidéo à partir d’un prompt textuel et d’une image de référence facultative. L’API accepte une requête Multipart compatible OpenAI Videos et renvoie un Video ID permettant de consulter l’état de la tâche.

Les durées, dimensions, images de référence et paramètres supplémentaires pris en charge varient selon le modèle vidéo. Choisissez l’identifiant d’un modèle visible pour la clé API actuelle et prenant en charge la génération de vidéos.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

multipart/form-data

Envoyez le prompt, le modèle et l’image de référence facultative en Multipart. Le client doit laisser la bibliothèque de requêtes générer automatiquement la boundary du Content-Type.

Définitions TypeScript

Utilisez le type request body en TypeScript.

prompt*string

Décrivez le contenu vidéo souhaité. Précisez de préférence le sujet, l’action, la scène, le cadrage, le style et les exigences de qualité.

Longueur1 <= length

model?string

Identifiant du modèle vidéo à utiliser. Choisissez un modèle visible pour la clé API actuelle et prenant en charge la génération de vidéos ; les formats d’entrée et les paramètres supplémentaires peuvent varier selon le modèle.

Longueur1 <= length

seconds?string

Durée de la vidéo, en secondes ; la valeur par défaut est 4. Les durées disponibles dépendent du modèle choisi.

Valeur par défaut"4"

size?string

Dimensions de la vidéo de sortie, généralement au format largeurxhauteur ; la valeur par défaut est 720x1280. Les dimensions disponibles dépendent du modèle choisi.

Valeur par défaut"720x1280"

input_reference?file

Image de référence téléversée pour la génération de vidéo à partir d’une image. Certains modèles compatibles n’acceptent pas le téléversement direct de fichiers ; utilisez alors metadata.img_url pour transmettre l’URL de l’image.

Formatbinary

metadata?string

Paramètres propres au fournisseur ou au modèle, à envoyer sous forme de chaîne JSON. Ne considérez pas ces champs comme des paramètres communs pris en charge par tous les modèles vidéo.

Les paramètres supplémentaires de la famille Wan comprennent img_url, first_frame_url, last_frame_url, watermark, prompt_extend, audio, seed et resolution. L’URL d’image sert à générer une vidéo à partir d’une image ; les URL de début et de fin servent aux vidéos à images clés. audio s’applique uniquement aux modèles prenant en charge la génération audio.

Les options de résolution comprennent 480P (832x480, 480x832, 624x624), 720P (1280x720, 720x1280, 960x960, 1088x832, 832x1088) et 1080P (1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632). Les résolutions effectivement prises en charge dépendent du modèle choisi.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="Un astronaute en combinaison spatiale marche sur la Lune, haute qualité, rendu cinématographique" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

Authentification

Corps de requête

Corps de réponse

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`