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"paraPOST /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_ide depois consultaGET /api/generate/status/{task_id}ou define umcallback_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 | |
|---|---|
| Programador | Kuaishou (Kling AI) |
| ID do modelo na API | kling-4.0-flash |
| Página do modelo | /pt/models/kling-4-0-flash |
| Modos | Texto para vídeo, imagem para vídeo (um frame inicial), referência para vídeo, edição de vídeo |
| Duração do clipe | 3–20 segundos, em segundos inteiros; predefinição 5 |
| Resolução | 720p (SDR de 8 bits, segundo a Kling) |
| Proporções | 16:9 (predefinida), 9:16, 1:1, 21:9, auto |
| Referências | Até 10 imagens, 5 vídeos e 7 sujeitos, 15 itens no total |
| Orçamento de vídeo de entrada | Todos os vídeos de origem, de referência e de sujeitos juntos até 20 segundos |
| Comprimento do prompt | Até 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:
| Modo | Envia | Notas |
|---|---|---|
| Texto para vídeo | prompt | Escolhe 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 frame inicial opcional em image_urls conta para o limite de 10 imagens |
| Edição de vídeo | video_url + prompt | Acrescenta 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.
| Campo | Tipo | Valores e limites | Predefinição |
|---|---|---|---|
model | string | kling-4.0-flash | Obrigatório |
callback_url | string | URL público 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 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_url | string | Ví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 é@Video1e 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í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 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)
| Trabalho | Segundos faturados | 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 |
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
- 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.
- 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.
- 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.
- Identifica cada entrada. Refere-te aos conteúdos como
@Image1,@Video1e@Element1, pela ordem dos arrays, e diz o que cada um controla: identidade, local, movimento ou estilo. - 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.
- 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.
- Pede enquadramentos limpos. Acrescenta “clean frame, free of text and logos” quando planeias acrescentar legendas ou a marca mais tarde.
- 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 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 |
| Frames | Um frame inicial | Frames iniciais e finais |
| Prompts com vários planos | Um prompt por clipe | multi_prompt com durações por plano |
| Referências na edição | Imagens, até 4 vídeos de referência e sujeitos | Imagens 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.