API de Controle de Movimento Kling V3 para Vídeo de Personagem Guiado por Referência

Acesse o Controle de Movimento Kling V3 através da GoEnhance com model: kling-v3-motion. Forneça referências de aparência e movimento, envie uma solicitação assíncrona e rastreie o img_uuid retornado por polling ou callback.
Obter Chave de API
Produção cinematográfica com referência de movimento para a API de Controle de Movimento Kling V3

Combine referências de aparência e movimento em uma única solicitação

Defina a aparência do personagem

Use image_url para uma imagem clara do personagem de corpo inteiro ou da cintura para cima, ou use no máximo um elemento Kling através de element_ids. A entrada de elemento força character_orientation: video.
Fotografia controlada com referência de aparência para geração de vídeo de personagens

Transfira movimento de um vídeo de referência

Forneça um MP4 ou MOV obrigatório em video_url. A saída segue o movimento contínuo utilizável desse arquivo; este endpoint não possui parâmetro de duration.
Ensaio de coreografia de cena única usado como referência de movimento
Valide a mídia antes do envio; valores de duração ou resolução não suportados devem ser rejeitados no lado do cliente.

Capacidades e regras de validação da API de Controle de Movimento Kling V3

Endpoint e modelo

POST para https://api.goenhance.ai/api/v1/videos/generations com model: kling-v3-motion.

Prompt

Envie um prompt obrigatório de até 2.500 caracteres para descrever o personagem, roupas, cena ou direção de geração relevante.

Entrada de aparência

Um image_url pode ser JPG, JPEG ou PNG, com até 50 MB, pelo menos 300 px por lado, com uma proporção de 1:2.5 a 2.5:1.

Entrada de movimento

O video_url obrigatório deve ser MP4 ou MOV, com no máximo 100 MB e dimensões de 340 a 3.850 px.

Orientação e duração

character_orientation: video aceita de 3 a 30 segundos; image aceita de 3 a 10 segundos. O padrão documentado é video.

Resolução e áudio

Escolha 720p ou 1080p; não há nível 4K. generate_audio mantém o som original do vídeo de movimento e é definido como falso por padrão.
O preço é por segundo gerado, enquanto o GoEnhance mede a duração do vídeo de movimento de entrada como o limite superior de cobrança da solicitação.

Preços da API de Controle de Movimento Kling V3

Taxa de 720p

6,3 tokens por segundo gerado, equivalente a $0.126/s aos $0.02 por token documentados.

Taxa de 1080p

8,4 tokens por segundo gerado, equivalente a $0.168/s aos $0.02 por token documentados.

Estimativa de custo

Estime o custo máximo da solicitação como a duração medida do vídeo de movimento multiplicada pela taxa exata da resolução selecionada.

Faturamento de entrada medido

O GoEnhance transfere e mede o video_url antes de deduzir os tokens, portanto, alterar o arquivo remoto após a medição não altera a entrada faturada.

A saída pode ser mais curta

O Kling extrai movimento contínuo utilizável, portanto, movimentos difíceis ou muito rápidos podem produzir uma saída mais curta do que o vídeo de referência.

Sem parâmetro de duração

Não envie duration; o endpoint o rejeita, e a duração da saída segue o movimento utilizável extraído do vídeo de referência.

Integre o Controle de Movimento Kling V3 em seis etapas

1

1. Crie uma chave de API

Crie uma chave de API do GoEnhance e envie-a no cabeçalho Authorization.
2

2. Valide ambas as referências

Verifique a clareza e as dimensões da imagem, depois verifique o formato, tamanho, dimensões e a duração dependente da orientação do vídeo de movimento.
3

3. Envie e persista a tarefa

Faça um POST da solicitação com model: kling-v3-motion, depois salve o img_uuid retornado antes de passar o trabalho para um processador em segundo plano.
4

4. Acompanhe o status

Faça polling em GET /api/v1/jobs/detail ou forneça um custom_callback_url HTTPS publicamente acessível.
5

5. Lide com callbacks de forma idempotente

Trate eventos de status repetidos com segurança. Um callback que não retorna HTTP 200 pode ser tentado novamente até três vezes com um tempo limite de três segundos por tentativa.
6

6. Armazene o resultado final

Separe o processamento, o sucesso e o tratamento de falhas, e salve a URL final do vídeo apenas após a tarefa atingir um estado terminal.
Obter chave de API
Use mídias que você está autorizado a processar e projete para conclusão assíncrona.

Casos de uso para desenvolvedores do Controle de Movimento Kling V3

Clipes de performance de personagens

Aplique referências de movimento aprovadas a uma aparência de personagem consistente para pipelines de vídeos narrativos ou promocionais curtos.

Prévias de dança e coreografia

Transfira movimentos de ensaio licenciados para prévias lideradas por personagens, preservando o consentimento e os direitos de áudio de origem.

Conceitos de animação de personagens de jogos

Gere estudos de movimento a partir de arte de personagens e movimentos gravados antes de se comprometer com um fluxo de trabalho de animação completo.

Variantes de campanha localizadas

Parametrize prompts e entradas de aparência para variantes criativas regionais enquanto reutiliza uma camada de orquestração de trabalho.

Fluxos de trabalho de artistas virtuais

Construa pipelines de artistas controlados em torno de referências de imagem, ativos de movimento e configurações de orientação aprovados.

Pré-visualização

Teste se uma referência de movimento é adequada para um personagem antes da edição, composição e revisão subsequentes.
Respostas para perguntas comuns sobre integração, preços, validação e a API da Kuaishou.

Perguntas Frequentes da API de Controle de Movimento Kling V3

Qual é o endpoint da API de Controle de Movimento Kling V3?

Envie através do GoEnhance em POST https://api.goenhance.ai/api/v1/videos/generations com model: kling-v3-motion. A resposta retorna um img_uuid.

Como funciona o preço da API de Controle de Movimento Kling V3?

720p custa 6,3 tokens/s ($0.126/s) e 1080p custa 8,4 tokens/s ($0.168/s). O GoEnhance mede a duração do vídeo de movimento antes da dedução como a cobrança do limite superior da solicitação.

Posso enviar um parâmetro de duração?

Não. Este endpoint rejeita duration. O vídeo de referência deve satisfazer os limites específicos de orientação, e a saída segue o movimento contínuo utilizável extraído dele.

O que o character_orientation altera?

video segue a direção da face no vídeo de movimento e permite de 3 a 30 segundos. image segue a imagem de aparência e permite de 3 a 10 segundos.

A API pode gerar áudio nativo?

Não. generate_audio apenas mantém a trilha sonora original do vídeo de movimento. O padrão é falso; use áudio apenas quando tiver os direitos necessários.

Posso usar um elemento Kling em vez de uma imagem?

A rota V3 aceita no máximo um valor através de element_ids (ou o alias de valor único element_id). A entrada de elemento força character_orientation: video.

Como funcionam os callbacks?

Forneça uma custom_callback_url HTTPS pública. O corpo do callback corresponde à resposta de detalhes do trabalho; entregas que não retornarem 200 podem ser tentadas novamente até três vezes com um tempo limite de três segundos.

Esta é a API oficial da Kuaishou?

Não. O Kling está associado à Kuaishou, mas esta página descreve o acesso independente através do GoEnhance. O GoEnhance não é apresentado como a API oficial, parceiro ou desenvolvedor de modelo da Kuaishou ou do Kling.

Construa com a API de Controle de Movimento Kling V3