guides

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

Poyo.ai Team
15 min read
Share:

Principais conclusões

  • O Kling 4.0 Flash é o escalão rápido e de menor custo do Kling 4.0. Cria 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. Envia "model": "kling-4.0-flash" para POST /api/generate/submit. Os conteúdos que incluis escolhem entre texto para vídeo, imagem para vídeo, referência para vídeo ou edição.
  • Custa $0.094 por segundo de saída na PoYo (18,8 créditos) em trabalhos de texto, imagem e referência de imagem, por isso um clipe de 5 segundos custa $0.47 e um de 10 segundos custa $0.94. Quando há vídeo na entrada, a tarifa é de $0.063 por segundo faturado.
  • Pagas conforme a utilização, com uma só chave. A PoYo fatura o Flash a partir de créditos pagos conforme a utilização, sem subscrição, e a mesma chave e o mesmo formato de pedido servem o Kling 4.0, o Gemini Omni e o Veo.
  • Os resultados são assíncronos. Guarda o task_id e depois consulta GET /api/generate/status/{task_id} ou define um callback_url.
  • Passar para o Kling 4.0 é mudar uma palavra. Os dois modelos partilham os mesmos campos de pedido; o Kling 4.0 acrescenta 1080p, clipes de 30 segundos, frames finais e prompts com vários planos.

Kling 4.0 Flash num relance

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

O que é o Kling 4.0 Flash?

O Kling 4.0 Flash é o membro focado na velocidade da família de vídeo Kling 4.0 da Kuaishou. O próprio guia da Kling descreve-o como pensado para criação frequente, combinando “geração rápida com um valor excelente”, e indica 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 frames iniciais e finais 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.

Usa o Flash quando o volume e a rapidez de entrega contam mais do que a resolução máxima: clipes para redes sociais, testes de ganchos e formatos, loops de produto, previs e rondas de rascunho antes de uma renderização final.

Um clipe em 720p do Kling 4.0 Flash: dois praticantes de artes marciais treinam num dojo de madeira banhado de sol. Exemplo da página do modelo na PoYo.

Um ID de modelo, quatro modos

A PoYo escolhe o modo a partir dos campos dentro de input:

ModoEnviaNotas
Texto para vídeopromptEscolhe 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 frame inicial opcional em image_urls conta para o limite de 10 imagens
Edição de vídeovideo_url + promptAcrescenta imagens de referência, até 4 vídeos de referência e sujeitos; o enquadramento acompanha o vídeo de origem

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

Parâmetros do pedido

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

CampoTipoValores e limitesPredefinição
modelstringkling-4.0-flashObrigatório
callback_urlstringURL público 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 sujeitos; 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 sujeitos 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: frame inicial + imagens de referência + vídeos de referência + sujeitos.
  • 20 segundos de vídeo de entrada no total: vídeo de origem + vídeos de referência + sujeitos 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 carregamento no Playground: MP4 ou MOV, até 200 MB por vídeo. Os URLs de multimédia têm de ser links HTTP ou HTTPS públicos.

Envia o teu primeiro pedido

Cria uma chave de API no painel da PoYo e guarda-a no teu servidor. Depois envia 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 com êxito devolve 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"
  }
}

Os erros de validação também podem chegar com HTTP 200 e code: 400, por isso verifica o campo code, além do estado HTTP. 402 significa que a conta precisa de mais créditos.

Mais exemplos de pedidos

Imagem para vídeo a partir de um frame 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 num ramo de bambu com neve sacode a neve e vira-se para a câmara. 5 segundos, 94 créditos. Exemplo da página do modelo na PoYo.

Referência para vídeo com um sujeito

O sujeito abaixo usa uma vista de frente e uma vista de lado. O prompt refere-se 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 gabardina amarela e gorro vermelho caminha pelo trilho da falésia em direção ao farol à hora dourada, construído a partir de uma imagem do local e de um sujeito com duas vistas. 8 segundos, 9:16, 150,4 créditos. Exemplo da página do modelo na PoYo.

Editar um clipe existente

Por predefiniçã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, mudado para a primavera com bambu verde e flores de cerejeira, enquanto o movimento do panda e o da câmara se mantêm iguais. 151,2 créditos. Exemplo da página do modelo na PoYo.

Consultar o estado da tarefa

Verifica uma tarefa a qualquer momento com o respetivo ID:

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

O estado 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 que falhou tem um error_message.

Um ciclo em Python com limite de tempo para o teu 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 ciclo esgotar o tempo, consulta o mesmo task_id mais tarde; cada novo envio é um clipe separado e faturado. Em pipelines de produção, um callback_url de nível superior substitui as consultas por um webhook.

Custo por clipe do Kling 4.0 Flash

A PoYo fatura o Flash ao segundo, com créditos pagos conforme a utilização ($1 = 200 créditos). Em trabalhos de texto, imagem e referência de imagem, pagas a duração da saída a uma tarifa única, com as imagens de referência e os sujeitos 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 comparação, o mesmo clipe de 5 segundos no Kling 4.0 em 720p custa $0.7125, por isso o Flash é cerca de 34% mais barato.

Com vídeo de entrada

Quando um pedido inclui um vídeo de origem, vídeos de referência ou sujeitos em vídeo, a tarifa é de 12,6 créditos ($0.063) por segundo faturado, em que:

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

TrabalhoSegundos faturadosCré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

As durações de entrada fracionárias são arredondadas para cima. A edição de primavera na página do modelo usou uma origem com pouco mais de 5 segundos, que contou como 6: 6 + 6 = 12 segundos faturados, ou 151,2 créditos. Para orçamentar em toda a família Kling 4.0, vê o nosso guia de preços da API Kling 4.0.

Dicas de prompt para o Kling 4.0 Flash

  1. Uma ação contínua por clipe. Os clipes curtos ficam mais estáveis quando o prompt acompanha um sujeito num único momento: “vira-se, faz uma pausa, olha para cima”. Guarda as histórias com vários momentos para clipes de 10–20 segundos, escritas como apresentação, ação e desfecho.
  2. Indica o movimento de câmara. Aproximação, órbita, travelling, panorâmica para cima. Coloca-o numa frase própria, para se destacar dos pormenores visuais.
  3. Descreve a luz e a textura. A hora do dia, a direção da luz e materiais como vidro molhado, metal escovado ou pelo dão a um clipe em 720p um aspeto nítido e consistente.
  4. Identifica cada entrada. Refere-te aos conteúdos como @Image1, @Video1 e @Element1, pela ordem dos arrays, e diz o que cada um controla: identidade, local, movimento ou estilo.
  5. Constrói os sujeitos com cuidado. Coloca primeiro a vista frontal, acrescenta 1–3 ângulos extra e mantém os fundos simples. Para um sujeito em vídeo, usa um único clipe nítido de 3–8 segundos.
  6. Começa as edições com “Edit @Video1”. Depois indica a alteração e enumera o que tem de ficar igual: identidade, movimento, ritmo e percurso da câmara.
  7. Pede enquadramentos limpos. Acrescenta “clean frame, free of text and logos” quando planeias acrescentar legendas ou a marca mais tarde.
  8. Ajusta a duração à ideia. Um clipe de 5 segundos cabe num gesto ou numa revelação. Guarda os 15–20 segundos para ações que precisam desse espaço, porque o custo aumenta a cada segundo.

Trabalho de câmara dirigido no Kling 4.0 Flash: a câmara circunda um carro de corrida em drift entre fumo, sob luzes de néon, e depois fixa-se na frente do carro. Exemplo da página do modelo na PoYo.

Para mais padrões de prompt que funcionam em toda a família, vê 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
FramesUm frame inicialFrames iniciais e finais
Prompts com vários planosUm prompt por clipemulti_prompt com durações por plano
Referências na ediçãoImagens, até 4 vídeos de referência e sujeitosImagens e sujeitos em imagem
Preço em 720p, trabalhos de texto e imagem$0.094/s$0.1425/s

Faz os rascunhos no Flash e passa a direção escolhida para o Kling 4.0 quando a versão final precisar de 1080p, de um frame final ou de mais de 20 segundos. Para a comparação completa, lê Kling 4.0 vs Flash. Para veres como o Flash se compara com os modelos de vídeo rápidos da Google, lê 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 no URL. Envia "model": "kling-4.0-flash" no corpo do pedido.

Quanto custa o Kling 4.0 Flash?

Na PoYo, 18,8 créditos ($0.094) por segundo de saída em trabalhos de texto, imagem e referência de imagem: $0.47 por 5 segundos, $0.94 por 10 segundos e $1.88 por 20 segundos. Quando há vídeo na entrada, são 12,6 créditos ($0.063) por segundo faturado.

O Kling 4 Flash é gratuito?

O Kling 4.0 Flash funciona com créditos pagos conforme a utilização na PoYo, sem subscrição. Cada execução é faturada do teu saldo de créditos, e o Playground mostra a estimativa de créditos antes de gerares, por isso podes verificar primeiro o custo de um prompt, de um conjunto de referências ou de uma edição.

Quanto podem durar os vídeos do Kling 4.0 Flash?

De 3 a 20 segundos por geração, em segundos inteiros. A predefinição é de 5 segundos, e as edições mantêm a duração da origem, a menos que definas 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 frame inicial ou de referências. Para 1080p, um frame final, multi_prompt ou clipes até 30 segundos, usa o Kling 4.0 com os mesmos campos de pedido.

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

A Kling descreve o Flash como o seu escalão mais rápido, pensado para criação frequente e iteração rápida. O tempo de geração depende da duração do clipe e da carga do momento, por isso cronometra alguns dos teus próprios prompts.

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

Sim. A chave da PoYo que corre o Kling 4.0 Flash corre também o Kling 4.0, o Gemini Omni 1.2 Flash, o Veo 3.1 e outros modelos, através dos mesmos endpoints de envio e de estado e de um único saldo de créditos.

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

Sim. Acrescenta um callback_url de nível superior, e a PoYo envia-lhe um POST quando a tarefa termina ou falha. Continuas a poder consultar o endpoint de estado com o mesmo task_id a qualquer momento.

Share: