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.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
Obter Chave de API
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.
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.
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 <code>https://api.goenhance.ai/api/v1/videos/generations</code> com <code>model: kling-v3-motion</code>.
Prompt
Envie um <code>prompt</code> 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 <code>image_url</code> 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 <code>video_url</code> 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
<code>character_orientation: video</code> aceita de 3 a 30 segundos; <code>image</code> aceita de 3 a 10 segundos. O padrão documentado é <code>video</code>.
Resolução e áudio
Escolha 720p ou 1080p; não há nível 4K. <code>generate_audio</code> 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 <code>video_url</code> 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 <code>duration</code>; 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.
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.