Vídeo e materiais
Listar Tarefas (Compatível com Volc)
Listar tarefas recentes de compatibilidade Seedance para a organização atual.
Visão Geral
Liste as tarefas de compatibilidade da organização autenticada usando uma chave de API Bearer do TokenLab. Apenas tarefas criadas através do endpoint de criação compatível com Volc são listadas. Sem filter.task_ids, os resultados cobrem tarefas dos últimos sete dias; fornecer IDs exatos consulta essas tarefas diretamente.
Veja também Modelos de Vídeo Seedance 2.0 e Geração de Vídeo.
Listagem e Filtros
page_num: padrão1, número inteiro de1a500.page_size: padrão20, número inteiro de1a500.filter.status:queued,running,succeeded,failed,cancelled,expired.filter.task_ids: Repita este parâmetro para múltiplos IDs de tarefa exatos; não os separe com vírgulas.filter.model: O valor demodelenviado quando a tarefa foi criada.filter.service_tier:default,flex.
A resposta contém items (a página solicitada) e total (todas as tarefas que correspondem aos filtros). Cada item utiliza o formato de resposta get-task. Um parâmetro não suportado ou um valor fora do intervalo retorna 400. Use o endpoint get para atualizar o status de uma tarefa conhecida.
Exemplo
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl -X GET "https://example.com/api/v3/contents/generations/tasks"{ "items": [ { "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 } ], "total": 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 consulta
Número da página.
1 <= value <= 5001Tamanho da página.
1 <= value <= 50020Filtrar por status da tarefa.
Valores permitidos
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
IDs de tarefa exatos. Repita filter.task_ids para múltiplos IDs.
Filtre pelo valor do modelo enviado quando a tarefa foi criada.
Filtrar por nível de serviço.
Valores permitidos
- "default"
- "flex"
Resposta
application/json
application/json
application/json
application/json