Saltar para o conteúdo 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"
}
Use este endpoint para iniciar uma tarefa de vídeo ByteDance Seedance a partir de texto, ou de texto mais imagens de referência. A solicitação retorna um id da tarefa imediatamente e a renderização continua de forma assíncrona.

​
Escolha o caminho do modelo atual

  • Use a página de Models para verificar a disponibilidade atual dos modelos e seus identificadores.
  • Use doubao-seedance-1-5-pro-251215 como o exemplo atual de produção para esta rota.
  • O mesmo modelo atual pode lidar tanto com solicitações somente de texto quanto com solicitações guiadas por imagem por meio do array content unificado.

​
Fluxo da tarefa

1

Monte o array content

Coloque primeiro a instrução principal em texto e depois adicione itens de imagem somente quando precisar de orientação para o primeiro ou o último frame.
2

Envie a tarefa

Salve o id da tarefa retornado. Se quiser entrega por push, defina callback_url ao criar a tarefa.
3

Faça polling até a saída chegar

Chame ByteDance Video Query até que a tarefa seja concluída e content.video_url esteja presente.

​
Comportamento conhecido do wrapper

Volcengine e Seedance documentam esta família como um fluxo assíncrono de criar e depois consultar. A CometAPI mantém esse mesmo padrão de tarefa, mas oferece uma única URL base e uma única API key.
Durante a validação ao vivo em 2026-03-12, esta rota estava acessível, mas ainda retornava um erro de parsing JSON no lado do servidor para um exemplo JSON padrão. Trate os exemplos OpenAPI aqui como a referência prática do wrapper e valide seu payload logo no início do desenvolvimento.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
model
string
obrigatório

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.

Exemplo:

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

​
content
object[]
obrigatório

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.

Resposta

200 - application/json

Task accepted.

​
id
string
obrigatório

Task id for later polling.