Génération de vidéo (asynchrone)

La génération vidéo prend beaucoup de temps (de quelques dizaines de secondes à plusieurs minutes) ; 4ALL API adopte un protocole asynchrone soumission + interrogation : soumettez d’abord la tâche pour obtenir task_id, puis interrogez les résultats.

1. Soumettre une tâche

POST https://api.4allapi.com/v1/video/generations

curl https://api.4allapi.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "Vue par drone sur la côte à l’aube, ambiance cinématographique, lumière naturelle",
    "size": "1280x720",
    "seconds": "8"
  }'

Réponse :

{ "task_id": "video-task-xxx", "status": "submitted" }

Paramètre	Description
`model`	Modèle vidéo, par exemple `veo-3.1`, `sora-2`, `kling-v3`, modèle vidéo `omni-flash`
`prompt`	Description de la scène et des mouvements de caméra
`size`	Résolution (paysage/portrait), selon la plage prise en charge par le modèle
`seconds`	Durée (en secondes), selon la plage prise en charge par le modèle
`image`	Image de référence de la première frame pour la génération d’image en vidéo (modèles pris en charge, URL ou base64)

2. Consulter le résultat

GET https://api.4allapi.com/v1/video/generations/{task_id}

curl https://api.4allapi.com/v1/video/generations/video-task-xxx \
  -H "Authorization: Bearer $AIPROXY_KEY"

status passera par submitted → processing → succeeded / failed ; en cas de succès, l’URL de téléchargement de la vidéo est renvoyée :

{
  "task_id": "video-task-xxx",
  "status": "succeeded",
  "video_url": "https://.../result.mp4"
}

Recommandations pour le polling

Interroger toutes les 5 à 10 secondes ; augmenter le délai global selon la durée du modèle (par exemple 10 minutes) ;
L’état failed inclura la raison de l’échec ; en cas d’échec pour non-conformité du contenu, ajustez le prompt puis soumettez à nouveau ;
Les liens vidéo ont une durée de validité limitée ; après génération réussie, transférez-les rapidement vers votre propre stockage.