Referência da API
Guias de Integração
Preços e Faturamento
ByteDance / Seedance
Consulta de Vídeo ByteDance
Recupere uma tarefa de geração de vídeo Bytedance por id via CometAPI — verifique status, progresso e detalhes de saída para /volc/v3/contents/generations/tasks.
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
--url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
--header 'Authorization: Bearer <token>'{
"id": "021773297205999example",
"model": "doubao-seedance-1-5-pro-251215",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated.mp4"
},
"created_at": 1773297205,
"updated_at": 1773297260,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24
}Use este endpoint depois de criar uma tarefa ByteDance Jimeng. Ele não inicia uma renderização. Ele apenas informa o estado atual da tarefa e, quando o job termina, a URL do vídeo gerado e os metadados de saída.
Observe estes campos
statuspara o estado atual do providercontent.video_urlquando a renderização estiver concluídaresolution,duration,ratioeframespersecondse sua aplicação precisar de metadados de saída
Loop de polling
Primeiro, crie uma tarefa
Comece com Geração de Vídeo ByteDance.
Faça polling pelo id da tarefa
Continue chamando este endpoint até que o status atinja um estado terminal.
URLs de resultado
O fluxo da ByteDance continua sendo criar primeiro e depois consultar pelo id da tarefa. A CometAPI mantém essa estrutura e padroniza a autenticação. Trate a URL de vídeo retornada como uma URL de entrega, não como armazenamento permanente.Autorizações
Bearer token authentication. Use your CometAPI key.
Parâmetros de caminho
Task id returned by the create endpoint.
Resposta
200 - application/json
Current task state.
⌘I
Query a ByteDance video task
curl --request GET \
--url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
--header 'Authorization: Bearer <token>'{
"id": "021773297205999example",
"model": "doubao-seedance-1-5-pro-251215",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated.mp4"
},
"created_at": 1773297205,
"updated_at": 1773297260,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24
}