Génération de vidéo

La génération de vidéo est asynchrone : soumettez une tâche pour obtenir un task_id, interrogez l'état de la tâche, puis récupérez l'URL de la vidéo une fois terminée.

Pages par modèle

Cette page couvre le flux commun de soumission, de récupération et d'interrogation. Pour la matrice de capacités, les champs de requête, les exemples par capacité et les tableaux de paramètres de chaque famille de vidéo, consultez les pages dédiées :

• Génération de vidéo SeeDance — Volcengine Ark Doubao Seedance (texte/image vers vidéo, première/dernière image, référence vidéo/continuation)
• Génération de vidéo HappyHorse — Alibaba Cloud Bailian DashScope (texte/image/référence vers vidéo, montage vidéo)

Points de terminaison

Pour les nouvelles intégrations Seedance/Doubao, privilégiez /v1/video/generations.

Corps de la requête

POST /v1/video/generations

Exemples corrects et incorrects

Incorrect : envoyer directement le corps content[] de niveau supérieur amont à TENSORAXIS.

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "An old man wearing a hat smiles and walks forward"
    }
  ]
}

Correct : utilisez les champs de requête TENSORAXIS et laissez le relais les traduire.

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "An old man wearing a hat smiles and walks forward",
  "images": ["https://example.com/reference.jpg"],
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "camera_fixed": true,
    "watermark": false
  }
}

Soumettre une tâche

curl https://api.tensoraxis.ai/v1/video/generations \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "An old man wearing a hat smiles and walks forward",
    "images": ["https://example.com/reference.jpg"],
    "metadata": {
      "resolution": "1080p",
      "ratio": "16:9",
      "duration": 5,
      "camera_fixed": true,
      "watermark": false
    }
  }'

Une réponse de soumission réussie renvoie un identifiant de tâche public. Les champs peuvent varier légèrement selon le canal vidéo, mais incluent généralement :

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1760000000
}

Enregistrez id ou task_id pour l'interrogation.

Récupérer une tâche

Si vous soumettez via le point de terminaison commun des tâches vidéo, interrogez avec :

curl https://api.tensoraxis.ai/v1/video/generations/task_xxxxx \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY"

La réponse commune de récupération utilise le format d'enveloppe de tâche :

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://example.com/video.mp4",
    "fail_reason": ""
  }
}

Significations courantes des statuts :

Le chemin de récupération au style OpenAI/Sora est :

curl https://api.tensoraxis.ai/v1/videos/task_xxxxx \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY"

Ce chemin renvoie une réponse object: "video" et, en cas de succès, expose l'URL de la vidéo sous forme de url, video_url et metadata.url.

Métadonnées Seedance/Doubao

Pour les canaux Doubao/Seedance, TENSORAXIS convertit prompt, images et metadata dans le format de tâche de génération de contenu Volcengine :

Remarques :

• metadata.model est supprimé et ne peut pas remplacer le modèle facturé.
• Les champs metadata qui ne correspondent pas à la structure de l'adaptateur actuel ne sont généralement pas transmis en amont.
• metadata.content est un champ de compatibilité interne avancé qui peut remplacer la liste de contenu générée à partir de images ; les intégrations publiques ne doivent pas l'utiliser.
• Les valeurs valides, les énumérations et le comportement réel en amont sont définis par la documentation officielle Volcengine du modèle sélectionné. Cette page documente uniquement la façon dont le relais TENSORAXIS actuel reçoit et transmet les champs.

Recommandations d'interrogation

• Attendez 2 à 5 secondes avant la première interrogation après la soumission.
• Interrogez toutes les 5 à 10 secondes pendant que la tâche est en cours de génération.
• N'utilisez pas d'interrogation à haute fréquence pour remplacer les callbacks ; mettez en file d'attente les lots volumineux dans votre application.
• Si vous recevez 429, réduisez la concurrence et réessayez avec un backoff exponentiel.