Passer au contenu principal
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
Utilisez cet endpoint pour démarrer une tâche vidéo ByteDance Seedance à partir de texte, ou de texte accompagné d’images de référence. La requête renvoie immédiatement un id de tâche et le rendu se poursuit de manière asynchrone.

​
Choisir le chemin du modèle actuel

  • Utilisez la page Models pour connaître la disponibilité actuelle des modèles et leurs identifiants.
  • Utilisez doubao-seedance-1-5-pro-251215 comme exemple de production actuel pour cette route.
  • Le même modèle actuel peut gérer à la fois les requêtes en texte seul et les requêtes guidées par image via le tableau content unifié.

​
Flux de tâche

1

Construire le tableau content

Placez l’instruction textuelle principale en premier, puis ajoutez des éléments image uniquement lorsque vous avez besoin d’un guidage sur la première ou la dernière image.
2

Soumettre la tâche

Enregistrez l’id de tâche renvoyé. Si vous souhaitez une livraison par push, définissez callback_url lors de la création de la tâche.
3

Interroger jusqu’à l’arrivée de la sortie

Appelez ByteDance Video Query jusqu’à ce que la tâche se termine et qu’un content.video_url soit présent.

​
Comportement connu du wrapper

Volcengine et Seedance documentent cette famille comme un flux de travail asynchrone de type création puis interrogation. CometAPI conserve ce même modèle de tâche, mais vous fournit une URL de base unique et une clé API unique.
Lors de la validation en conditions réelles le 2026-03-12, cette route était accessible mais renvoyait encore une erreur d’analyse JSON côté serveur pour un exemple JSON standard. Considérez les exemples OpenAPI ici comme la référence pratique du wrapper, et validez votre payload dès le début du développement.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
​
model
string
requis

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

Exemple:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
requis

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

Réponse

200 - application/json

Task accepted.

​
id
string
requis

Task id for later polling.