Créer une vidéo

Envoyez une requête avec une structure JSON unifiée pour obtenir un ID de tâche. Les paramètres propres au modèle sont transmis via les champs communs ou metadata.

POST/v1/video/generations

Créez une tâche asynchrone de génération de vidéo à partir d’un prompt textuel et d’une image facultative. L’API renvoie task_id, qui permet de consulter ensuite l’état et le résultat de la tâche.

Les formats d’entrée et les paramètres propres aux fournisseurs peuvent varier selon le modèle. Choisissez un modèle visible pour la clé API actuelle et prenant en charge la génération de vidéos, et transmettez uniquement les paramètres qu’il prend en charge.

Authentification

bearerAuth

AuthentificationBearer <token>

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

Emplacement: header

Corps de requête

application/json

Envoyez le modèle, le prompt et les paramètres facultatifs de génération de vidéo en JSON.

Définitions TypeScript

Utilisez le type request body en TypeScript.

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.

Longueur1 <= length

prompt*string

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

Longueur1 <= length

duration?number

Durée de la vidéo, en secondes. Les valeurs disponibles dépendent du modèle choisi.

fps?integer

Fréquence d’images de la vidéo de sortie. Sa prise en charge et les valeurs disponibles dépendent du modèle choisi.

height?integer

Hauteur de la vidéo de sortie. Peut être utilisée avec width ; sa prise en charge dépend du modèle choisi.

width?integer

Largeur de la vidéo de sortie. Peut être utilisée avec height ; sa prise en charge dépend du modèle choisi.

size?string

Dimensions de la vidéo de sortie, généralement au format largeurxhauteur ; les dimensions disponibles dépendent du modèle choisi.

image?string

Image d’entrée pour la génération de vidéo à partir d’une image. Il peut s’agir d’une URL d’image ou de données Base64 ; le format d’entrée dépend du modèle choisi.

metadata?

Paramètres propres au fournisseur ou au modèle, tels que negative_prompt, style, quality_level, les images de début et de fin, ou l’URL de callback. La présence de ces champs ne signifie pas que tous les modèles vidéo les prennent en charge.

n?integer

Nombre de vidéos à générer. Sa prise en charge et les valeurs disponibles dépendent du modèle choisi.

response_format?string

Format de réponse souhaité. Les valeurs disponibles dépendent du modèle et du canal choisis.

seed?integer

Seed permettant de contrôler le caractère aléatoire de la génération. Sa prise en charge dépend du modèle choisi.

user?string

Identifiant de l’utilisateur final fourni par l’appelant.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Un astronaute en combinaison spatiale marche sur la Lune, haute qualité, rendu cinématographique",    "size": "1920x1080",    "image": "https://example.com/input.jpg",    "duration": 5,    "metadata": {      "seed": 20231234,      "negative_prompt": "Flou",      "image_tail": "https://example.com/end-frame.png"    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

Authentification

Corps de requête

Corps de réponse

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`