Vídeo e materiais

Listar Tarefas (Compatível com Volc)

Listar tarefas recentes de compatibilidade Seedance para a organização atual.

GET
/api/v3/contents/generations/tasks

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ão 1, número inteiro de 1 a 500.
  • page_size: padrão 20, número inteiro de 1 a 500.
  • 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 de model enviado 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
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de consulta

page_num?integer

Número da página.

Intervalo1 <= value <= 500
padrão1
page_size?integer

Tamanho da página.

Intervalo1 <= value <= 500
padrão20
filter.status?string

Filtrar por status da tarefa.

Valores permitidos

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

IDs de tarefa exatos. Repita filter.task_ids para múltiplos IDs.

filter.model?string

Filtre pelo valor do modelo enviado quando a tarefa foi criada.

filter.service_tier?string

Filtrar por nível de serviço.

Valores permitidos

  • "default"
  • "flex"

Resposta

application/json

application/json

application/json

application/json