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"paraPOST /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_ide depois consulteGET /api/generate/status/{task_id}ou defina umacallback_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 | |
|---|---|
| Desenvolvedor | Kuaishou (Kling AI) |
| ID do modelo na API | kling-4.0-flash |
| Página do modelo | /pt-BR/models/kling-4-0-flash |
| Modos | Texto para vídeo, imagem para vídeo (um quadro inicial), referência para vídeo, edição de vídeo |
| Duração do clipe | 3–20 segundos, em segundos inteiros; padrão 5 |
| Resolução | 720p (SDR de 8 bits, segundo a Kling) |
| Proporções | 16:9 (padrão), 9:16, 1:1, 21:9, auto |
| Referências | Até 10 imagens, 5 vídeos e 7 elementos, 15 itens no total |
| Limite de vídeo de entrada | Todos os vídeos de origem, de referência e de elementos somados, até 20 segundos |
| Tamanho do prompt | Até 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:
| Modo | Envie | Observações |
|---|---|---|
| Texto para vídeo | prompt | Escolha o aspect_ratio |
| Imagem para vídeo | image_urls com exatamente uma imagem | prompt é opcional; a imagem inicial define o enquadramento |
| Referência para vídeo | reference_image_urls, reference_video_urls e/ou kling_elements | Um quadro inicial opcional em image_urls conta para o limite de 10 imagens |
| Edição de vídeo | video_url + prompt | Acrescente 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.
| Campo | Tipo | Valores e limites | Padrão |
|---|---|---|---|
model | string | kling-4.0-flash | Obrigatório |
callback_url | string | URL pública que recebe um POST quando a tarefa termina ou falha | — |
prompt | string | 1–26.000 caracteres; obrigatório em texto, referência e edição; opcional em imagem para vídeo | — |
duration | integer | 3–20 | 5; na edição, a duração da origem |
resolution | string | 720p | 720p |
aspect_ratio | string | auto, 16:9, 9:16, 1:1, 21:9 (modos de texto e de referência) | 16:9 |
image_urls | array | Exatamente uma imagem inicial | — |
reference_image_urls | array | Até 10 imagens | — |
reference_video_urls | array | Até 5 vídeos (4 na edição), cada um com 3–20 segundos | — |
kling_elements | array | Até 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_url | string | Ví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ída | Créditos | USD |
|---|---|---|
| 3 s | 56,4 | $0.282 |
| 5 s | 94 | $0.47 |
| 8 s | 150,4 | $0.752 |
| 10 s | 188 | $0.94 |
| 15 s | 282 | $1.41 |
| 20 s | 376 | $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)
| Trabalho | Segundos cobrados | Créditos | USD |
|---|---|---|---|
| Clipe de 5 s guiado por um vídeo de referência de 4 s | 5 + max(4, 5) = 10 | 126 | $0.63 |
| Clipe de 10 s guiado por 12 s de vídeo de referência | 10 + max(12, 10) = 22 | 277,2 | $1.386 |
| Editar um clipe de 8 s mantendo a duração | 8 + max(8, 8) = 16 | 201,6 | $1.008 |
| Editar um clipe de 15 s com um vídeo de referência de 5 s | 15 + max(20, 15) = 35 | 441 | $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
- 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.
- 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.
- 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.
- Marque cada entrada. Refira-se às mídias como
@Image1,@Video1e@Element1, na ordem dos arrays, e diga o que cada uma controla: identidade, local, movimento ou estilo. - 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.
- 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.
- Peça quadros limpos. Acrescente “clean frame, free of text and logos” quando for incluir legendas ou marca depois.
- 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 Flash | Kling 4.0 | |
|---|---|---|
| ID do modelo | kling-4.0-flash | kling-4.0 |
| Resolução | 720p | 720p, 1080p |
| Duração do clipe | 3–20 s | 3–30 s |
| Quadros | Um quadro inicial | Quadros inicial e final |
| Prompts com vários planos | Um prompt por clipe | multi_prompt com duração por plano |
| Referências na edição | Imagens, até 4 vídeos de referência e elementos | Imagens 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.