Migrar Seedance do Volcengine

Use este guia quando sua aplicação já envia solicitações Seedance no formato Volcengine. Nomes de Action, Version=2024-01-01, content[], corpos PascalCase de materiais e o envelope de resposta Volcengine podem ser mantidos. Apenas endpoint e autenticação precisam mudar.

O que muda

Item	Cliente Volcengine existente	TokenLab
URL base	`Volcengine API`	`https://api.tokenlab.sh/`
Autenticação	`AK/SK`	`Authorization: Bearer <TOKENLAB_API_KEY>`
Solicitação Action	`Action`, `Version`	`Action`, `Version`
Corpo da tarefa	`content[]`	`content[]`
Corpo do material	`PascalCase`	`PascalCase`
Resultado assíncrono	`ID da tarefa`	`cgt-...` + Polling

Solicitações apenas com assinatura AK/SK retornam 401 InvalidCredential. Clientes Action podem usar POST /?Action=...&Version=2024-01-01; POST /api/v3?Action=...&Version=2024-01-01 continua disponível. Clientes REST usam /api/v3/contents/generations/tasks.

Formato da solicitação e ciclo da tarefa

Se sua integração já envia solicitações Seedance no estilo Volc, use o endpoint compatível em vez de remodelar o body para /v1/videos/generations. Envie sua API key TokenLab como Authorization: Bearer ..., use POST /api/v3/contents/generations/tasks para criação REST ou /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 para solicitações Action. A criação retorna um ID cgt-...; respostas de status usam queued, running, succeeded, failed, cancelled ou expired. Este endpoint compatível aceita itens content[] como text, image_url, video_url, audio_url e draft_task. Papéis de imagem como first_frame, last_frame e reference_image são preservados. callback_url ainda não é suportado; consulte o endpoint de tarefa.

Páginas de referência

Actions de tarefa

Action	Item	JSON
`CreateContentsGenerationsTasks`	Criar tarefa de vídeo	`model`, `content[]`
`GetContentsGenerationsTask`	Obter uma tarefa	`TaskId`
`ListContentsGenerationsTasks`	Listar tarefas	Filtros, paginação
`DeleteContentsGenerationsTasks`	Cancelar ou excluir tarefa	`TaskId`

Exemplo Action mínimo

curl 'https://api.tokenlab.sh/?Action=CreateContentsGenerationsTasks&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

Materiais e verificação de pessoas

O mesmo endpoint Action aceita dez operações de materiais e grupos. Consulte Actions de materiais compatíveis com Volcengine para corpos PascalCase, filtros, paginação, envelope e URLs de 12 horas. Para pessoas reais, antes do upload também use Criar sessão de verificação visual e Obter resultado da verificação visual.

Checklist de migração

Troque o host da API por https://api.tokenlab.sh.
Substitua a assinatura AK/SK por uma chave API Bearer do TokenLab.
Mantenha Action, versão e capitalização do corpo.
Use o mesmo ProjectName em solicitações relacionadas de materiais e verificação.
Armazene os IDs de tarefa, grupo e material retornados pelo TokenLab.
Valide criação, polling, listagem e erro antes de mover tráfego de produção.

Primeiros passos

Guias principais

Guias de mídia

Migrar Seedance do Volcengine

O que muda

Formato da solicitação e ciclo da tarefa

Páginas de referência

Actions de tarefa

Exemplo Action mínimo

Materiais e verificação de pessoas

Checklist de migração

​O que muda

​Formato da solicitação e ciclo da tarefa

​Páginas de referência

​Actions de tarefa

​Exemplo Action mínimo

​Materiais e verificação de pessoas

​Checklist de migração

O que muda

Formato da solicitação e ciclo da tarefa

Páginas de referência

Actions de tarefa

Exemplo Action mínimo

Materiais e verificação de pessoas

Checklist de migração