guides

API do Kling 4.0 Flash: parâmetros, preços e código

Poyo.ai Team
15 min read
Share:

Principais pontos

  • O Kling 4.0 Flash é a faixa rápida e de menor custo do Kling 4.0. Ele gera clipes de 3–20 segundos em 720p a partir de texto, de uma imagem inicial ou de referências, e edita vídeos existentes.
  • Um único ID de modelo cobre todos os modos. Envie "model": "kling-4.0-flash" para POST /api/generate/submit. A mídia que você inclui define se é texto para vídeo, imagem para vídeo, referência para vídeo ou edição.
  • Custa US$ 0,094 por segundo de saída na PoYo (18,8 créditos) em trabalhos com texto, imagem e referência de imagem, então um clipe de 5 segundos sai por US$ 0,47 e um de 10 segundos, por US$ 0,94. Quando há vídeo na entrada, a tarifa é de US$ 0,063 por segundo cobrado.
  • Pagamento conforme o uso com uma única chave. A PoYo cobra o Flash com créditos pagos conforme o uso e sem assinatura, e a mesma chave e o mesmo formato de solicitação rodam o Kling 4.0, o Gemini Omni e o Veo.
  • Os resultados são assíncronos. Guarde o task_id e depois consulte GET /api/generate/status/{task_id} ou defina uma callback_url.
  • Passar para o Kling 4.0 é mudar uma palavra. Os dois modelos compartilham os mesmos campos de solicitação; o Kling 4.0 acrescenta 1080p, clipes de 30 segundos, quadros finais e prompts com vários planos.

Kling 4.0 Flash em resumo

Kling 4.0 Flash na PoYo
DesenvolvedorKuaishou (Kling AI)
ID do modelo na APIkling-4.0-flash
Página do modelo/pt-BR/models/kling-4-0-flash
ModosTexto para vídeo, imagem para vídeo (um quadro inicial), referência para vídeo, edição de vídeo
Duração do clipe3–20 segundos, em segundos inteiros; padrão 5
Resolução720p (SDR de 8 bits, segundo a Kling)
Proporções16:9 (padrão), 9:16, 1:1, 21:9, auto
ReferênciasAté 10 imagens, 5 vídeos e 7 elementos, 15 itens no total
Limite de vídeo de entradaTodos os vídeos de origem, de referência e de elementos somados, até 20 segundos
Tamanho do promptAté 26.000 caracteres
Preço$0.094/s · $0.063 por segundo cobrado com entrada de vídeo

O que é o Kling 4.0 Flash?

O Kling 4.0 Flash é o integrante focado em velocidade da família de vídeo Kling 4.0, da Kuaishou. O guia da própria Kling o descreve como feito para criação frequente, combinando “geração rápida com excelente custo-benefício”, e lista clipes de 3–20 segundos em 720p com texto para vídeo, imagem para vídeo e Omni Reference. O modelo completo Kling 4.0 vai até 30 segundos e 1080p na PoYo e acrescenta quadros inicial e final e prompts com vários planos.

“Kling 4 Flash” e “Kling 4.0 Flash” são o mesmo modelo. Na PoYo, o slug da página é kling-4-0-flash e o ID do modelo na API é kling-4.0-flash, com ponto.

Use o Flash quando volume e prazo importam mais que a resolução máxima: clipes para redes sociais, testes de gancho e de formato, loops de produto, pré-visualização e rodadas de rascunho antes da renderização final.

Um clipe em 720p do Kling 4.0 Flash: dois lutadores de artes marciais treinam em um dojo de madeira ensolarado. Exemplo da página do modelo na PoYo.

Um ID de modelo, quatro modos

A PoYo escolhe o modo pelos campos dentro de input:

ModoEnvieObservações
Texto para vídeopromptEscolha o aspect_ratio
Imagem para vídeoimage_urls com exatamente uma imagemprompt é opcional; a imagem inicial define o enquadramento
Referência para vídeoreference_image_urls, reference_video_urls e/ou kling_elementsUm quadro inicial opcional em image_urls conta para o limite de 10 imagens
Edição de vídeovideo_url + promptAcrescente imagens de referência, até 4 vídeos de referência e elementos; o enquadramento acompanha o vídeo de origem

A prioridade é fixa: video_url ativa a edição, qualquer campo de referência ativa referência para vídeo, image_urls sozinho ativa imagem para vídeo, e um prompt sozinho ativa texto para vídeo.

Parâmetros da solicitação

model e callback_url ficam no nível superior; todos os outros campos ficam dentro de input.

CampoTipoValores e limitesPadrão
modelstringkling-4.0-flashObrigatório
callback_urlstringURL pública que recebe um POST quando a tarefa termina ou falha—
promptstring1–26.000 caracteres; obrigatório em texto, referência e edição; opcional em imagem para vídeo—
durationinteger3–205; na edição, a duração da origem
resolutionstring720p720p
aspect_ratiostringauto, 16:9, 9:16, 1:1, 21:9 (modos de texto e de referência)16:9
image_urlsarrayExatamente uma imagem inicial—
reference_image_urlsarrayAté 10 imagens—
reference_video_urlsarrayAté 5 vídeos (4 na edição), cada um com 3–20 segundos—
kling_elementsarrayAté 7 elementos; cada um tem element_input_urls (2–4 imagens, com a vista frontal primeiro) ou element_input_video_urls (exatamente um vídeo de 3–8 segundos); até 3 elementos em vídeo—
video_urlstringVídeo de origem para edição, 3–20 segundos—

Limites comuns a validar antes de enviar:

  • 15 itens no total: quadro inicial + imagens de referência + vídeos de referência + elementos.
  • 20 segundos de vídeo de entrada no total: vídeo de origem + vídeos de referência + elementos em vídeo.
  • As tags seguem a ordem dos arrays: @Image1, @Video1, @Element1. Na edição, o vídeo de origem é @Video1, e os vídeos de referência começam em @Video2.
  • Formatos de upload no Playground: MP4 ou MOV, até 200 MB por vídeo. As URLs de mídia precisam ser links públicos HTTP ou HTTPS.

Envie a sua primeira solicitação

Crie uma chave de API no painel da PoYo e mantenha-a no seu servidor. Depois, envie uma tarefa de texto para vídeo de cinco segundos:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "A ceramic mug of coffee steams on a wooden windowsill as rain streaks the glass. Slow push-in, soft morning light, clean frame free of text and logos.",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

Um envio bem-sucedido retorna code: 200 e uma tarefa em data:

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

Erros de validação também podem voltar com HTTP 200 e code: 400, então confira o campo code além do status HTTP. 402 significa que a conta precisa de mais créditos.

Mais exemplos de solicitação

Imagem para vídeo a partir de um quadro inicial

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "The red panda shakes the snow off its fur, then turns toward the camera. Slow push-in, shallow depth of field.",
    "duration": 5
  }
}

Resultado de imagem para vídeo: um panda-vermelho em um galho de bambu coberto de neve sacode a neve e se vira para a câmera. 5 segundos, 94 créditos. Exemplo da página do modelo na PoYo.

Referência para vídeo com um elemento

O elemento abaixo usa uma vista frontal e uma vista lateral. O prompt se refere a ele como @Element1 e à imagem do local como @Image1:

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "@Element1 walks along the cliff-top path toward the lighthouse in @Image1 at golden hour. The camera tracks beside him as he stops and looks up at the lamp. Keep his face and yellow raincoat consistent with @Element1.",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

Resultado de referência para vídeo: um faroleiro de capa de chuva amarela e gorro vermelho caminha pela trilha do penhasco em direção ao farol na hora dourada, criado a partir de uma imagem do local e de um elemento com duas vistas. 8 segundos, 9:16, 150,4 créditos. Exemplo da página do modelo na PoYo.

Edite um clipe existente

Por padrão, a saída mantém a duração da origem:

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1 and change the season from winter to spring, using @Image1 as the environment reference. Keep the animal, its movements, timing and camera motion exactly as in @Video1."
  }
}

Resultado da edição: o clipe do panda-vermelho na neve, mostrado acima, levado para a primavera com bambu verde e flores de cerejeira, enquanto o movimento do panda e o da câmera continuam iguais. 151,2 créditos. Exemplo da página do modelo na PoYo.

Consulte o status da tarefa

Consulte uma tarefa a qualquer momento pelo ID:

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

O status passa de not_started para running e depois para finished ou failed. Uma tarefa concluída lista o vídeo em data.files, com file_url e file_type: "video". Uma tarefa com falha traz uma error_message.

Um loop em Python com limite de tempo para o seu backend:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "A paper lantern drifts up over a night market. Slow tilt up, warm light, glowing stalls below.",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

Se o loop atingir o tempo limite, consulte o mesmo task_id mais tarde; cada novo envio é um clipe separado e cobrado. Em pipelines de produção, uma callback_url no nível superior substitui a consulta por um webhook.

Custo por clipe do Kling 4.0 Flash

A PoYo cobra o Flash por segundo, com créditos pagos conforme o uso (US$ 1 = 200 créditos). Em trabalhos com texto, imagem e referência de imagem, você paga a duração da saída por uma tarifa única, com imagens de referência e elementos em imagem incluídos.

Duração da saídaCréditosUSD
3 s56,4$0.282
5 s94$0.47
8 s150,4$0.752
10 s188$0.94
15 s282$1.41
20 s376$1.88

Para comparar, o mesmo clipe de 5 segundos no Kling 4.0 em 720p custa US$ 0,7125, então o Flash sai cerca de 34% mais barato.

Com entrada de vídeo

Quando uma solicitação inclui um vídeo de origem, vídeos de referência ou elementos em vídeo, a tarifa é de 12,6 créditos (US$ 0,063) por segundo cobrado, em que:

segundos cobrados = duração da saída + max(duração total do vídeo de entrada arredondada para cima, duração da saída)

TrabalhoSegundos cobradosCréditosUSD
Clipe de 5 s guiado por um vídeo de referência de 4 s5 + max(4, 5) = 10126$0.63
Clipe de 10 s guiado por 12 s de vídeo de referência10 + max(12, 10) = 22277,2$1.386
Editar um clipe de 8 s mantendo a duração8 + max(8, 8) = 16201,6$1.008
Editar um clipe de 15 s com um vídeo de referência de 5 s15 + max(20, 15) = 35441$2.205

Durações de entrada fracionadas são arredondadas para cima. A edição de primavera da página do modelo usou uma origem de pouco mais de 5 segundos, que contou como 6: 6 + 6 = 12 segundos cobrados, ou 151,2 créditos. Para planejar o orçamento de toda a família Kling 4.0, veja nosso guia de preços da API do Kling 4.0.

Dicas de prompt para o Kling 4.0 Flash

  1. Uma ação contínua por clipe. Clipes curtos ficam mais estáveis quando o prompt acompanha um sujeito em um único momento: “vira, para, olha para cima”. Deixe histórias com vários momentos para clipes de 10–20 segundos, escritas como apresentação, ação e desfecho.
  2. Nomeie o movimento de câmera. Aproximação, órbita, travelling, inclinação para cima. Coloque-o em uma frase própria para que se destaque dos detalhes visuais.
  3. Descreva luz e textura. Hora do dia, direção da luz e materiais como vidro molhado, metal escovado ou pelo dão a um clipe em 720p uma aparência clara e consistente.
  4. Marque cada entrada. Refira-se às mídias como @Image1, @Video1 e @Element1, na ordem dos arrays, e diga o que cada uma controla: identidade, local, movimento ou estilo.
  5. Monte os elementos com cuidado. Coloque a vista frontal primeiro, acrescente 1–3 ângulos extras e mantenha os fundos simples. Para um elemento em vídeo, use um clipe nítido de 3–8 segundos.
  6. Comece as edições com “Edit @Video1”. Depois, diga qual é a mudança e liste o que deve continuar igual: identidade, movimento, tempo e trajetória da câmera.
  7. Peça quadros limpos. Acrescente “clean frame, free of text and logos” quando for incluir legendas ou marca depois.
  8. Ajuste a duração à ideia. Um clipe de 5 segundos comporta um gesto ou uma revelação. Deixe 15–20 segundos para ações que precisam de espaço, já que o custo cresce a cada segundo.

Movimento de câmera dirigido no Kling 4.0 Flash: a câmera circula um carro de corrida que derrapa em meio à fumaça sob luzes de neon e depois para na frente dele. Exemplo da página do modelo na PoYo.

Para mais padrões de prompt que funcionam em toda a família, veja o guia de prompts do Kling 4.0 e o guia do Omni Reference.

Kling 4.0 Flash vs. Kling 4.0 em resumo

Kling 4.0 FlashKling 4.0
ID do modelokling-4.0-flashkling-4.0
Resolução720p720p, 1080p
Duração do clipe3–20 s3–30 s
QuadrosUm quadro inicialQuadros inicial e final
Prompts com vários planosUm prompt por clipemulti_prompt com duração por plano
Referências na ediçãoImagens, até 4 vídeos de referência e elementosImagens e elementos em imagem
Preço em 720p, trabalhos com texto e imagem$0.094/s$0.1425/s

Faça os rascunhos no Flash e leve a direção escolhida para o Kling 4.0 quando o corte final precisar de 1080p, de um quadro final ou de mais de 20 segundos. Para a comparação completa, leia Kling 4.0 vs. Flash. Para ver como o Flash se compara aos modelos de vídeo rápidos do Google, leia Gemini Omni 1.2 Flash vs. Kling 4.0 Flash vs. Veo 3.1.

Perguntas frequentes

Qual é o ID do modelo Kling 4.0 Flash?

kling-4.0-flash. O slug da página, kling-4-0-flash, é usado na URL. Envie "model": "kling-4.0-flash" no corpo da solicitação.

Quanto custa o Kling 4.0 Flash?

Na PoYo, 18,8 créditos (US$ 0,094) por segundo de saída em trabalhos com texto, imagem e referência de imagem: US$ 0,47 por 5 segundos, US$ 0,94 por 10 segundos e US$ 1,88 por 20 segundos. Quando há vídeo na entrada, são 12,6 créditos (US$ 0,063) por segundo cobrado.

O Kling 4 Flash é gratuito?

O Kling 4.0 Flash roda com créditos pagos conforme o uso na PoYo, sem assinatura. Cada execução é cobrada do seu saldo de créditos, e o Playground mostra a estimativa de créditos antes da geração, para que você confira primeiro o custo de um prompt, de um conjunto de referências ou de uma edição.

Qual pode ser a duração dos vídeos do Kling 4.0 Flash?

De 3 a 20 segundos por geração, em segundos inteiros. O padrão é de 5 segundos, e as edições mantêm a duração da origem, a menos que você defina duration.

Quando devo passar do Flash para o Kling 4.0?

O Flash foi feito para clipes em 720p a partir de um prompt, de um quadro inicial ou de referências. Para 1080p, quadro final, multi_prompt ou clipes de até 30 segundos, use o Kling 4.0 com os mesmos campos de solicitação.

O Kling 4.0 Flash é mais rápido que o Kling 4.0?

A Kling descreve o Flash como a sua faixa mais rápida, feita para criação frequente e iteração ágil. O tempo de geração depende da duração do clipe e da carga do momento, então cronometre alguns dos seus próprios prompts.

Posso usar a mesma chave para outros modelos de vídeo?

Sim. A chave da PoYo que roda o Kling 4.0 Flash também roda o Kling 4.0, o Gemini Omni 1.2 Flash, o Veo 3.1 e outros modelos, pelos mesmos endpoints de envio e status e com um único saldo de créditos.

Posso receber um webhook quando o vídeo estiver pronto?

Sim. Acrescente uma callback_url no nível superior, e a PoYo envia um POST para ela quando a tarefa termina ou falha. Você continua podendo consultar o endpoint de status com o mesmo task_id a qualquer momento.

Share: