Vídeo e materiais
Obter Tarefa (Compatível com Volc)
Obtenha uma tarefa de compatibilidade Seedance pelo seu ID de tarefa cgt.
Visão Geral
Use o ID cgt-... retornado pela criação. Faça polling a cada poucos segundos enquanto a tarefa estiver como queued ou running. Pare quando a tarefa estiver como succeeded, failed, cancelled ou expired.
Não reutilize o enum de tarefa unificado v1 ou a struct de resposta aqui. /v1/tasks/{id} usa pending, processing, completed e failed; este endpoint v3 usa o enum oficial acima. No objeto JSON v3, duration é uma string quando presente e error é opcional e contém detalhes do erro quando disponível. Um cliente Go rigoroso deve declarar Duration como string com a tag JSON duration,omitempty e parar em cada status terminal da v3.
Veja também Modelos de Vídeo Seedance 2.0 e Geração de Vídeo.
Valores de Status
queued: aceito e aguardando execução.running: a geração está em andamento.succeeded: o resultado está pronto econtent.video_urlestá presente.failed: a geração falhou; inspecioneerror.codeeerror.message.cancelled: a tarefa foi cancelada antes da conclusão.expired: a tarefa expirou antes da conclusão.
Campos de Resposta
id: ID da tarefa de compatibilidade, começando comcgt-.model: o valor demodelque você enviou ao criar a tarefa.status: um dos valores de status acima.content.video_url: URL final do vídeo em caso de sucesso. É um link de resultado TokenLab que permanece válido por 30 dias; veja Retenção de dados.content.last_frame_url: presente apenas quando solicitado e disponível.usage:completion_tokensetotal_tokensquando disponíveis, além detool_usage.web_searchquando a ferramenta de busca na web foi executada.created_ateupdated_at: timestamps Unix em segundos.error:{ code, message }quando detalhes do erro estão disponíveis. Não infira sua presença apenas a partir dostatus.- Os valores da requisição definidos para a tarefa são ecoados quando disponíveis:
seed,resolution,ratio,duration(string),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,frameseframespersecond.
A resposta nunca adiciona campos TokenLab como progress, return_last_frame, watermark, priority ou camera_fixed.
Um ID de tarefa desconhecido ou expirado retorna 404; um ID que pertence a outra organização retorna 403.
Exemplo
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
-H "Authorization: Bearer $TOKENLAB_API_KEY"{
"id": "cgt-20260102030405-a1b2c",
"model": "seedance-2.0",
"status": "succeeded",
"content": {
"video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
},
"usage": {
"completion_tokens": 123456
}
}type SeedanceTask struct {
ID string `json:"id"`
Status string `json:"status"`
Duration string `json:"duration,omitempty"`
}
func isTerminal(status string) bool {
switch status {
case "succeeded", "failed", "cancelled", "expired":
return true
default:
return false
}
}curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"{ "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
ID da tarefa de compatibilidade retornado pelo endpoint de criação. Os IDs começam com cgt-.
Resposta
application/json
application/json
application/json
application/json
application/json
application/json