Acesse por um contrato público unificado fluxos como texto para vídeo, imagem para vídeo, referência para vídeo, controle de quadro inicial/final, controle de movimento e vídeo para vídeo.
A TokenLab oferece geração de vídeo por meio de uma API unificada. A geração é assíncrona: você envia uma solicitação, recebe task_id e poll_url, e então faz polling até obter o resultado final.
Você pode consultar o inventário público atual de modelos de vídeo pela Models API ou pela página de modelos.Se uma resposta de criação retornar poll_url, chame exatamente essa URL. Quando ela apontar para /v1/tasks/{id}, trate-a como o endpoint fixo canônico de status.
O comportamento de áudio depende do modelo. Na TokenLab, a família Veo 3 é tratada por padrão como áudio ativado quando output_audio é omitido. Outros modelos públicos são silenciosos por padrão ou não expõem um alternador estável de áudio.Em produção, prefira URLs https públicas para imagens, vídeos e áudio. Modelos compatíveis continuam aceitando URLs data:, mas URLs públicas são mais robustas para retries, observabilidade e depuração.
O contrato público de vídeo da TokenLab hoje se concentra nestas operações:
text-to-video
image-to-video
reference-to-video
start-end-to-video
video-to-video
motion-control
O contrato também aceita audio-to-video e video-extension para fluxos específicos de alguns modelos, mas nesta compilação da documentação não há nenhum modelo amplamente habilitado que publique essas capacidades.
Legenda: ✅ Existe pelo menos um modelo público atualmente habilitado nessa família de provedores com essa capacidade | ❌ Não há modelos públicos atualmente habilitados com essa capacidade
Use kling_elements com kling-3.0-video quando precisar de referências de elementos. Forneça uma solicitação condicionada por imagem (image_url, image_urls, start_image ou end_image) e referencie cada elemento no prompt com @name. Não combine kling_elements com output_audio=true; omita output_audio ou defina como false em solicitações com referências de elementos.
Para seedance-2.0 e seedance-2.0-fast, a TokenLab suporta atualmente até 9 imagens de referência, além de até 3 vídeos de referência e 3 áudios de referência. duration controla apenas a duração do resultado gerado; ele não define um limite separado para a duração do vídeo de referência de entrada.
response = requests.post(f"{BASE}/videos/generations", headers=headers, json={ "model": "veo3.1", "prompt": "Keep the same subject identity and palette while adding subtle motion.", "operation": "reference-to-video", "reference_images": [ "https://example.com/ref-a.jpg", "https://example.com/ref-b.jpg" ], "duration": 8, "resolution": "720p", "aspect_ratio": "9:16" })
Em produção, vale a pena informá-lo explicitamente
image_url
string
Forma mais robusta de entrada de imagem
image
string
URL data: útil para testes locais e integrações pequenas
reference_images
string[]
Campo público canônico para condicionamento por referências
reference_image_type
string
Seletor opcional asset / style
video_url
string
Obrigatório para os modelos públicos atuais de video-to-video e motion-control
audio_url
string
Para fluxos específicos de áudio para vídeo
output_audio
boolean
A família Veo 3 trata a omissão como true. kling-3.0-video aceita esse seletor para o controle upstream sound e fica silencioso por padrão quando omitido.
Se a qualidade for mais importante que a velocidade, veo3.1-pro, kling-video-o1-pro e viduq3-pro são escolhas fortes.
Iteração rápida
Para ciclos rápidos, veo3.1-fast, hailuo-2.3-fast e viduq3-turbo são bons pontos de partida.
Fluxos com referência
Se você precisa de controle dedicado por imagens de referência, comece com veo3.1, veo3.1-fast, wan-2.6 ou kling-video-o1-pro / std.
Vídeo para vídeo
Hoje, os principais caminhos públicos geralmente habilitados para video-to-video são topaz-video-upscale, grok-imagine-upscale e kling-video-o1-pro / std.
A cobrança depende do modelo. Alguns modelos públicos de vídeo se comportam, na prática, como modelos cobrados por solicitação, enquanto outros se aproximam mais de uma cobrança por segundo. Para a superfície pública de preços atual, consulte a página de modelos ou a Pricing API.
