Skip to main content
A geração de vídeo é assíncrona. POST /v1/videos/generations retorna uma identidade de tarefa pública e geralmente um poll_url; o vídeo final aparece em respostas de status posteriores. Quando o modelo Seedance selecionado pode usar a biblioteca de materiais do TokenLab, URLs de imagem e data URLs inline compatíveis são preparadas como materiais reutilizáveis do TokenLab antes da geração. Se a preparação levar mais de 60 segundos, tente novamente quando os auto_material_asset_ids retornados estiverem ACTIVE. Se o modelo selecionado não puder usar a biblioteca de materiais, entradas comuns de imagem continuam pelo caminho normal de imagem.

​
Operações compatíveis

Use operation explícito em produção. O TokenLab pode inferir algumas operações a partir das entradas, mas valores de operação explícitos tornam a validação, suporte e tentativas mais claros.

​
Descoberta de Modelos

Use os IDs de modelo mostrados pelo TokenLab em model e escolha variantes de recurso com operation e as entradas de mídia correspondentes. Exemplos: wan-2.7, happyhorse-1.0, viduq3, viduq3-mix, pixverse-v6, kling-3.0-video, veo3.1 e seedance-2.0; não use sufixos específicos de operação como nomes de modelo do TokenLab. Leia os detalhes do modelo selecionado antes de confiar em campos especializados, como reference_images, kling_elements, output_audio, duration, resolution ou aspect_ratio.

​
Criar Solicitação

Para entrada de mídia em produção, prefira URLs públicas https em vez de URLs data: inline. Se você usar URLs temporárias, mantenha-as válidas até o TokenLab terminar de criar a tarefa.

​
Entradas E Campos Específicos do Modelo

  • Solicitações da família Veo 3 padrão para áudio ativado quando output_audio é omitido. Defina-o explicitamente quando o modelo suportar a alternância e sua experiência do usuário depender de som.
  • kling_elements é para solicitações condicionadas por imagem de kling-3.0-video. Referencie cada elemento em prompt como @name; não combine com output_audio=true.
  • Para a família Seedance 2.0, leia o guia de modelos de vídeo Seedance 2.0 antes de usar saída 4K, limites Fast/Mini ou entradas de referência multimodais.
  • Para grok-imagine-video, vídeo-para-vídeo usa um video_url público .mp4; limites específicos do modelo, como duration e resolution, devem vir do detalhe do modelo.

​
PixVerse e HappyHorse

No TokenLab, os modelos PixVerse acima não aceitam operation=video-extension.

​
Resultados de Polling

Use o poll_url retornado primeiro. Se precisar de um endpoint fixo, use GET /v1/tasks/{id} com o mesmo id / task_id da resposta de criação. Tarefas de vídeo concluídas podem retornar video_url, video ou videos, dependendo do modelo e da contagem de saída. Trate billing_transaction_id como um identificador de cobrança, não como um identificador de tarefa.

​
Armadilhas Comuns

  • Não codifique caminhos de status de vídeo antigos; prefira poll_url.
  • Não combine campos de primeiro quadro com fluxos dedicados de imagem de referência, a menos que o detalhe do modelo permita.
  • Não assuma que duration descreve o comprimento do vídeo de referência de entrada; geralmente controla o comprimento da saída gerada.
  • Não tente recriar solicitações após um timeout sem verificar se uma tarefa já foi criada.

​
Referência da API

​
APIs de vídeo estilo OpenAI e compatíveis com Volc

Use /v1/videos/generations para a API unificada de vídeo da TokenLab entre modelos. Se você estiver migrando uma integração Seedance 2.0 que já usa content[] ou solicitações Action no estilo Volc, use os endpoints de compatibilidade Seedance em /api/v3. Ambos os estilos usam TokenLab Bearer API keys e polling assíncrono, mas seus formatos de solicitação e resposta são diferentes.