Kling AI · MCP + CLI

Gere vídeos e imagens no Kling por comando

O Kling AI dentro do seu terminal e do seu assistente de IA: texto→vídeo, imagem→vídeo, geração em lote e dublagem com voz clonada.

Ilustração de geração de vídeo com IA
O que é

O Kling AI fora do site, dentro do seu fluxo

O Kling oferece duas portas oficiais de automação — o MCP (para assistentes como Claude e Cursor) e o CLI (para terminal, scripts e CI). Este projeto documenta as duas e o pipeline completo de produção de vídeo.

🎬 Vídeo e imagem por prompt

text_to_video, image_to_video, text_to_image e image_to_image — os modelos Kling 3.0 (até 4K, multi-shot, áudio nativo) e também Nano Banana Pro e GPT Image na mesma CLI.

⚙️ Automação de verdade

Jobs assíncronos com generation_id, poll por status, lote de até 4 variações por request e integração em scripts, Makefiles e pipelines de CI.

🎙️ Dublagem com voz clonada

Receita completa para trocar o áudio nativo por uma voz clonada mantendo o lip-sync: transcrição com timestamps, TTS multi-tomada e alinhamento por compasso.

Como funciona

Do prompt ao vídeo final

O fluxo de produção que o guia ensina, de ponta a ponta:

Prompt / imagem kling image_to_video poll query_tasks download (24h!) dublagem / concat MP4 final
Pré-requisitos

O que você precisa

Conta no Kling AI (créditos pagos — sem geração off-peak grátis via MCP/CLI), Node.js e ffmpeg para a pós-produção.

Kling CLI

Instala global via npm e autentica por OAuth no navegador.

# instalar + login
npm i -g @klingai/cli-global
kling login

Ou o MCP

Para usar direto no Claude ou Cursor, sem terminal (instale um OU outro, nunca os dois).

# conector MCP
"klingai": {"url": "https://kling.ai/mcp"}

ffmpeg

Concat, troca de áudio e montagem de trilha de dublagem.

# checar
ffmpeg -version
Guia de uso · passo a passo

Do zero ao primeiro vídeo

Comandos reais — cada geração retorna um generation_id; o resultado sai como URL que expira em 24h.

1

Descubra os modelos da sua conta

Sempre chame primeiro — retorna os modelos disponíveis e os parâmetros exatos de cada um.

kling who_am_i   # modelos, durações, resoluções, parâmetros
kling account    # plano e créditos
2

Gere uma imagem (a cena)

720p/1k gasta menos créditos; suba a resolução só quando o resultado valer.

kling text_to_image "cidade futurista ao entardecer, luz dourada, cinematográfico" --poll
3

Anime a cena em vídeo

Para 1 imagem, o kling3.0-turbo é o melhor custo-benefício. Fala em PT? Escreva o prompt inteiro em português, com a fala entre aspas.

kling image_to_video --image cena.png --model kling3.0-turbo \
  --resolution 720p "câmera avança lentamente, atmosfera cinematográfica" --poll
4

Acompanhe e baixe na hora

Jobs não podem ser cancelados e as URLs de resultado expiram em 24 horas — salve o generation_id e baixe assim que completar.

kling query_tasks <generation_id>   # status + works[].url
curl -o video.mp4 "<works[].url>"
5

Monte o vídeo final

Clipes com specs iguais concatenam sem re-encode. Para voz própria, use a receita de dublagem do guia (transcrição com timestamps + TTS por frase + alinhamento por compasso).

# concatenar clipes
printf "file 'c1.mp4'\nfile 'c2.mp4'\n" > lista.txt
ffmpeg -f concat -safe 0 -i lista.txt -c copy final.mp4
# trocar o áudio pela narração dublada
ffmpeg -i final.mp4 -i narracao.wav -map 0:v -map 1:a -c:v copy saida.mp4
Exemplos

Feito com este fluxo

Avatar falante gerado do zero: thumbnail estática → image_to_video com prompt em PT-BR → dublagem com voz clonada alinhada por compasso.

Frame do vídeo de avatar falante gerado no Kling
Thumbnail estática animada em avatar falante (kling3.0-omni, prompt 100% em PT-BR, lip-sync nativo).
Comparativo lado a lado do áudio original e da dublagem
Controle de qualidade: original e dublagem lado a lado, um áudio em cada canal, para auditar o compasso.
Roadmap

Próximos passos do projeto

O que já funciona e o que vem por aí.

Feito
Guia MCP + CLI completoInstalação, comandos, tabela de modelos, limites de créditos e dicas de automação.
Feito
Receita de dublagem com voz clonadaTranscrição por palavra, TTS multi-tomada, alinhamento por compasso e verificação automática.
Próximo
Script único de pipelineUm comando que leva do prompt ao MP4 dublado (gerar → poll → baixar → dublar → montar).
Ideia
Lote de cenas por roteiroLer um roteiro decupado e gerar todas as cenas/variações em lote com imageCount.