kling-v3-omni. Combine um prompt obrigatório com o primeiro e o último quadro, imagens de referência ou um vídeo de referência e, em seguida, rastreie o resultado assíncrono pelo img_uuid.API Kling 3.0 Omni para Geração de Vídeo Multimodal
Acesse o Kling 3.0 Omni através da GoEnhance com o modelo
Obter Chave de API
Um endpoint para referências de prompt, imagem e vídeo
Endereçar materiais de referência dentro do prompt
As imagens são numeradas a partir de @image_1 na ordem de primeiro quadro, último quadro e depois ref_imgs. Um vídeo de referência é @video_1, portanto, a ordenação estável do array mantém as referências do prompt determinísticas.
Usar comportamento de recurso ou vídeo de referência base
Com video_type: feature, a saída segue o movimento e o estilo da referência; a geração de áudio é rejeitada e o multi-shot é forçado. Com base, o vídeo de origem é editado no local, o primeiro/último quadro e o multi-shot não estão disponíveis, e o áudio existente é mantido.
Valide combinações específicas de função antes de colocar uma tarefa de geração na fila.
Capacidades e regras de validação da API Kling 3.0 Omni
Modelo e prompt
Faça um POST para <code>https://api.goenhance.ai/api/v1/videos/generations</code> com o <code>model: kling-v3-omni</code> obrigatório e um <code>prompt</code> obrigatório.
Primeiro e último quadros
Use <code>image_url</code> para um primeiro quadro. <code>image_end_url</code> requer esse primeiro quadro; solicitações apenas com o último quadro não são suportadas.
Imagens de referência
Passe valores ordenados de <code>ref_imgs</code> e refira-se a eles com <code>@image_N</code>. O alias compatível <code>image_urls</code> também é aceito.
Vídeo de referência
Passe no máximo um MP4 ou MOV de 3 a 15,5 segundos através de <code>ref_videos</code>. <code>video_url</code> é um alias compatível.
Controles de saída
Escolha uma duração inteira de 3 a 15 segundos, resolução 720p/1080p/4K e proporção 16:9, 9:16 ou 1:1 quando nenhum primeiro quadro ou vídeo de referência determinar a proporção.
Limites de material
O primeiro quadro, o último quadro e as imagens de referência podem totalizar até sete materiais, ou até quatro quando um vídeo de referência está incluído.
O preço é por segundo gerado e depende da resolução, do uso de vídeo de referência e do áudio nativo.
Preços da API Kling 3.0 Omni
720p · sem vídeo, sem áudio
4,2 tokens por segundo gerado ($0.084/s).
720p · áudio nativo
5,6 tokens por segundo gerado ($0.112/s) quando não há vídeo de referência.
720p · com vídeo de referência
6,3 tokens por segundo gerado ($0.126/s).
Níveis de 1080p
5,6 tokens/s ($0.112/s) sem vídeo ou áudio, 7 tokens/s ($0.14/s) com áudio nativo e sem vídeo, ou 8,4 tokens/s ($0.168/s) com um vídeo de referência.
4K
21 tokens por segundo gerado ($0.42/s) em todos os cenários documentados de sem áudio, áudio nativo e vídeo de referência.
Estime cada solicitação
Multiplique a duração solicitada pela taxa exata para a resolução selecionada, uso de vídeo de referência e modo de áudio. Os equivalentes em USD usam os $0.02 por token documentados.
Integre o Kling 3.0 Omni em seis etapas
1
1. Crie uma chave de API
Crie uma chave de API GoEnhance e envie-a no cabeçalho
Authorization. 2
2. Selecione o modelo
Defina
model como kling-v3-omni e escreva um prompt que aborde explicitamente qualquer material @image_N ou @video_1. 3
3. Valide os materiais
Verifique as dependências de quadros, contagens de material, duração do vídeo de referência e as restrições para o modo
feature ou base. 4
4. Envie a tarefa
Faça um POST da solicitação para
/api/v1/videos/generations e persista o img_uuid retornado. 5
5. Acompanhe a conclusão
Faça polling em
GET /api/v1/jobs/detail ou forneça uma custom_callback_url HTTPS publicamente acessível. 6
6. Lide com estados terminais
Processe o sucesso e a falha de forma idempotente. Receptores de callback que não retornam HTTP 200 podem ser tentados novamente até três vezes com um tempo limite de três segundos por tentativa.
Crie fluxos de trabalho de vídeo multimodais em torno de funções de entrada explícitas e referências de material determinísticas.
Casos de uso para desenvolvedores do Kling 3.0 Omni
Clipes de campanha baseados em referência
Combine quadros-chave aprovados e referências visuais com modelos de prompt controlados para variantes de campanha repetíveis.
Estudos de movimento de produto
Use um primeiro quadro ou imagens de referência ordenadas para explorar o movimento do produto enquanto seu aplicativo gerencia a validação e as aprovações de ativos.
Pipelines de reestilização de vídeo
Use um vídeo de referência de recurso quando o movimento e o estilo devem orientar uma nova saída, sujeito às suas regras de áudio e múltiplas tomadas.
Edições de vídeo base
Use o modo base quando um vídeo existente precisar ser editado no local, mantendo seu áudio original.
Transições de storyboard
Use entradas de primeiro e último quadro para planejar uma transição entre batidas visuais aprovadas sem alterar a orquestração do seu trabalho.
Automação criativa localizada
Parametrize prompts e referências de material para variantes regionais enquanto reutiliza o mesmo manipulador de tarefas assíncronas.
Respostas práticas para validação de solicitações, preços, referências e conclusão assíncrona.