Como usar a API do Kling 2.5 Turbo? Coloque seu primeiro vídeo no ar em 5 minutos

TL;DR

• Kling 2.5 Turbo é a versão rápida do modelo de vídeo do Kling (Kuaishou); no HiAPI há duas entradas, texto para vídeo e imagem para vídeo, abra a página do modelo para testar online; novos usuários ganham 200 créditos ao se registrar.
• As duas entradas custam $0.06 por segundo: 5 segundos $0.30, 10 segundos $0.60.
• Como chamar: envie um POST /v1/tasks, consulte o resultado com taskId; o vídeo final fica em output[0].url.

O que o Kling 2.5 Turbo faz

• 5 ou 10 segundos, cerca de 1080p: a resolução acompanha a proporção; 16:9 gera 1920×1080, sem configuração separada.
• Texto para vídeo com áudio próprio: toda saída tem faixa de áudio, sem opção de desligar.
• Imagem para vídeo com suporte a último quadro: o primeiro quadro define o começo, o último define o fim, e o modelo completa o processo intermediário.
• Imagem para vídeo com 6 formatos: além de horizontal, vertical e quadrado, também 4:3, 3:4 e 21:9 widescreen.

Vertical cinematic shot of a ceramic artist in a sunlit studio. Her hands shape a small terracotta bowl on a spinning pottery wheel. The wet clay gradually rises as the wheel turns, a little water glints on the surface. The camera gently tracks upward from the bowl to her focused face. Warm morning light, linen apron, natural movement, one continuous shot, no text or logos.

Gerar com este prompt → (escolha 10 segundos, 9:16)

kling-2.5-turbo/text-to-video, 9:16, 1080×1920, 10 segundos, com faixa de áudio, $0.60.

Como escolher entre as duas entradas

ID do modelo	Entrada	Formatos	Som	Indicado para
kling-2.5-turbo/text-to-video	Prompt	16:9, 9:16, 1:1	Faixa de áudio própria	Sem material, começar pelo texto
kling-2.5-turbo/image-to-video	Primeiro quadro obrigatório, último quadro opcional	6 formatos; com último quadro, 3	Sem faixa de áudio	Fotos de produto, fotografia, ilustrações que precisam se movimentar

As duas entradas têm o mesmo preço: $0.06 por segundo.

Dois caminhos para começar

Testar no navegador (3 passos)

1. Abra a página do modelo de texto para vídeo ou imagem para vídeo e faça login.
2. Escreva o prompt; para imagem para vídeo, envie primeiro o primeiro quadro e, se necessário, o último quadro.
3. Escolha 5 segundos e o formato, e clique em executar.

Chamar pela API (3 passos)

1. Crie uma chave na página de API Key do console e coloque na variável de ambiente HIAPI_KEY.
2. Envie um POST https://api.hiapi.ai/v1/tasks e receba data.taskId.
3. Consulte com GET /v1/tasks/{taskId} até status ser success e baixe output[0].url.

curl: o primeiro vídeo

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5-turbo/text-to-video",
    "input": {
      "prompt": "Hands pour glossy caramel over a stack of pancakes, steam rises, camera slowly pushes in, warm kitchen light",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 segundos, 16:9, $0.30. Para imagem para vídeo, troque model por kling-2.5-turbo/image-to-video e adicione "image_urls": ["https://seu-servidor-de-imagens/frame.jpg"].

Python: enviar, consultar e baixar

# pip install requests; antes execute export HIAPI_KEY=sua_Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # Ao repetir a mesma tarefa, use o mesmo Idempotency-Key para evitar cobrança duplicada
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Primeiro quadro + último quadro: o carro vermelho vai da esquerda para a direita e vira azul (5 segundos, $0.30)
url = generate(
    "kling-2.5-turbo/image-to-video",
    prompt="A toy car moves smoothly from the left to the right and changes from red to blue. "
           "Keep the simple light grey background and beige ground. Continuous static camera shot.",
    image_urls=["https://seu-servidor-de-imagens/first.png", "https://seu-servidor-de-imagens/last.png"],
    duration=5, aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Primeiro e último quadro: faça o enquadramento parar na imagem desejada

Passe duas imagens em image_urls: a primeira é o primeiro quadro, a segunda é o último quadro. Abaixo, o primeiro quadro é o carro vermelho à esquerda e o último quadro é o carro azul à direita:

Primeiro quadro	Último quadro

A toy car moves smoothly from the left to the right and changes from red to blue. Keep the simple light grey background and beige ground. Continuous static camera shot.

Gerar com este prompt → (envie o primeiro e o último quadro, escolha 5 segundos, 9:16)

kling-2.5-turbo/image-to-video, 9:16, 1080×1920, 5 segundos, primeiro + último quadro, $0.30.

O carro vai para a direita, no meio do caminho a cor muda de vermelho para roxo e depois para azul, e por fim para na posição do último quadro, com o fundo inalterado do começo ao fim. O resultado é mais estável quando as duas imagens são iguais exceto pelo que deve mudar. Com o último quadro, o formato só pode ser 16:9, 9:16 ou 1:1.

Tabela de parâmetros

Campo	Obrigatório	Valores	Descrição
prompt	Sim	1–2500 caracteres	Descreva a ação e o enquadramento; em imagem para vídeo não é preciso descrever a cena
duration	Não	5 (padrão) / 10	Cobrança por segundo
aspect_ratio	Não	Texto: 16:9 (padrão) 9:16 1:1; imagem também tem 4:3 3:4 21:9	Com último quadro, apenas 16:9 9:16 1:1
image_urls	Obrigatório em imagem	1–2 imagens, jpeg/png/webp, até 10MB cada	A 1ª é o primeiro quadro, a 2ª é o último quadro; texto para vídeo não aceita este campo
negative_prompt	Não	Texto ≤2500, imagem ≤2496 caracteres	O que você não quer que apareça
cfg_scale	Não	0–1, padrão 0.5	Quanto maior, mais fiel ao prompt

Não há resolution, seed nem opção de som.

Erros que você vai encontrar

Se os parâmetros estiverem errados no envio, a API retorna 400 direto, sem criar tarefa e sem cobrar:

• duration: value must be one of 5, 10: a duração só pode ser 5 ou 10.
• aspect_ratio: value must be one of '16:9', '9:16', '1:1': texto para vídeo recebeu outro formato, ou imagem para vídeo com último quadro escolheu 4:3, 3:4 ou 21:9.
• image_urls: maxItems: got 3, want 2: no máximo duas imagens, primeiro e último quadro.
• image_urls: missing required field "image_urls": imagem para vídeo sem o primeiro quadro.
• cfg_scale: maximum: got 5, want 1: cfg_scale vai de 0 a 1, não é o 1–20 comum em outros modelos.
• additional properties 'seed', 'sound' not allowed: esses dois campos não existem.

Atenção antes de ir para produção

• Use callback em vez de polling: no nível superior da requisição (no mesmo nível de input), adicione "callback": {"url": "https://seu-dominio/hiapi/callback"} e deduplique por taskId.
• Salve o resultado logo: output[0].url expira em cerca de 7 dias; ao receber, salve no seu próprio armazenamento.
• Escreva duration e aspect_ratio explicitamente: sem isso, são 5 segundos e 16:9, e a necessidade de vertical é fácil de esquecer.
• Use chave de idempotência nas tentativas: adicione Idempotency-Key no header; a mesma chave cria a tarefa apenas uma vez.

Perguntas frequentes

Dá para desligar o som no texto para vídeo?

Não, não há opção de som. Se não quiser áudio, remova a faixa na edição, ou use imagem para vídeo, que já não tem faixa de áudio.

O que acontece se a proporção do primeiro quadro em imagem para vídeo for diferente do formato?

O primeiro quadro é cortado centralizado no formato escolhido. Uma imagem 16:9 com formato 9:16 mantém uma faixa vertical central; o mais seguro é deixar o assunto no centro.

Dá para gerar em 4K?

Não. A saída é cerca de 1080p, conforme o formato; a mais larga é 21:9 com 2200×940.

Como escolher entre ele e o Kling 3.0 Turbo?

Se 5 ou 10 segundos bastam e você quer o menor preço, escolha o Kling 2.5 Turbo; se precisa de 3–15 segundos com escolha segundo a segundo, ou de escolher entre 720p e 1080p, veja Comparação entre Kling 2.5 Turbo e 3.0 Turbo.

Para detalhes de preço, veja Preço da API do Kling 2.5 Turbo; para mais cenários, veja Guia completo de prompts do Kling 2.5 Turbo. Para ver o resultado primeiro, copie o prompt de cerâmica acima e gere seu primeiro vídeo na página do modelo.