
A Kling Image 4.0 API (kling-4.0-image) é a sucessora da Kling O3 Image API (kling-o3-image e kling-o3-image-edit) na PoYo. Em resumo: o Kling Image 4.0 acrescenta 8K, séries de imagens, um prompt de 50,000 caracteres e um modelo separado para páginas longas, e custa cerca de três a quatro vezes mais por imagem. Este artigo compara os dois pedido a pedido para que possa decidir que chamadas migrar. Ambos estão na PoYo: Kling Image 4.0 e Kling O3 Image.
A decisão numa tabela
| Se o seu pedido precisa de… | Chame |
|---|---|
| Saída em 1K, ou o preço mais baixo por imagem | kling-o3-image / kling-o3-image-edit |
| JPEG ou WebP diretamente da API | Kling O3 Image (output_format) |
| Mais de 4K, ou exatamente 8K | kling-4.0-image |
| Uma série de 2–10 imagens com o mesmo sujeito e estilo | kling-4.0-image com enable_sequential |
| Prompts com mais de 2,000 caracteres | kling-4.0-image (até 50,000) |
| Uma página web completa ou página de detalhe de ecommerce como uma única imagem | kling-4.0-long-image |
| Texto para imagem e edição num só ID de modelo | kling-4.0-image |
Diferenças do pedido campo a campo
Ambos usam POST https://api.poyo.ai/api/generate/submit, o mesmo endpoint de estado e o mesmo callback_url. As diferenças estão em model e input, retiradas da documentação da PoYo de cada modelo.
| Campo | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image (texto para imagem), kling-o3-image-edit (edição) | kling-4.0-image para ambos; image_urls ativa o modo de edição |
prompt | até 2,000 caracteres | 1–50,000 caracteres |
image_urls | 1–10, obrigatório para kling-o3-image-edit | 1–10 (opcional); 30 MB, ≥300 px, proporção 0.4–2.5 cada |
| Elementos | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}], 2–4 vistas, até 7, imagens + elementos ≤ 10 |
resolution | 1K (predefinição), 2K, 4K | 2K (predefinição), 4K, 8K |
size | 8 proporções, predefinição 16:9; auto só no modelo de edição | as mesmas 8 proporções mais auto, predefinição auto |
output_format | jpeg, png (predefinição), webp | não aceite; só PNG |
n | 1–9 | 1–9 independentes, ou 2–10 com enable_sequential: true |
enable_sequential | não disponível | true devolve uma série ordenada e consistente |
| Páginas longas | não disponível | modelo separado kling-4.0-long-image |
A Kling descreve o Kling Image 4.0 na sua publicação de lançamento como o seu primeiro modelo com geração nativa em 8K, capaz de planear até 10 imagens a partir de um prompt e de apresentar até 2,000 caracteres de texto em sete idiomas. Estas são afirmações da Kling; as diferenças de API acima são o que muda no seu código.
Preço para o mesmo pedido
Preços da PoYo, 1 crédito = $0.005. O Kling O3 Image não tem taxa de referência na PoYo; a Kling Image 4.0 API acrescenta 1 crédito por imagem de referência ou elemento, uma vez por pedido. A própria página de preços da Kling assinala a mesma alteração: o Kling Image 4.0 cobra as entradas de referência e os modelos anteriores não.
| Mesmo pedido | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 imagem, 1K | 3.5 créditos ($0.0175) | não disponível (mínimo 2K: 13 créditos) |
| 1 imagem, 2K | 3.5 créditos ($0.0175) | 13 créditos ($0.065) |
| 1 imagem, 4K | 7 créditos ($0.035) | 19 créditos ($0.095) |
| 1 imagem, 8K | não disponível | 32 créditos ($0.16) |
| Edição 2K, 2 imagens de referência + 1 elemento | 3.5 créditos ($0.0175) | 16 créditos ($0.08) |
| 4 imagens em 2K | 14 créditos ($0.07), independentes | 52 créditos ($0.26), em série ou independentes |
| Design de página web, 1K | não disponível | 110 créditos ($0.55) |
Em 2K a Kling Image 4.0 API custa cerca de 3.7× o Kling O3 Image por imagem, e cerca de 2.7× em 4K. As tabelas completas do Kling Image 4.0 estão em preços da Kling Image 4.0 API.
Limites que mudam
- O mínimo de resolução sobe. O 1K desaparece; a saída mais pequena do Kling Image 4.0 é 2K. Se serve miniaturas, mantenha-as no O3 ou redimensione do seu lado.
- O máximo sobe para 8K. A documentação da PoYo indica 8192×8192 em 1:1. No nosso teste do dia do lançamento (API de produção da PoYo, 19 de novembro de 2026), um pedido 16:9 em 8K devolveu um PNG de 10880×6144 com cerca de 128 MB e demorou cerca de 3.8 minutos, a 32 créditos.
- Tratamento de ficheiros. Sem
output_format: recebe PNG. As nossas transferências foram PNG RGBA mesmo para imagens opacas. Planeie a conversão e o armazenamento se usavajpegouwebpno O3. - As regras de referência são explícitas. O Kling Image 4.0 valida cada referência: até 30 MB, pelo menos 300 px por lado, largura/altura entre 0.4 e 2.5. A documentação do O3 não indica estes limites, por isso valide imagens muito largas ou pequenas antes de migrar.
- As séries demoram mais. A nossa série de quatro imagens em 2K demorou cerca de 4.9 minutos. Passe os trabalhos longos ou grandes para
callback_url.
Quando mudar
Passe uma chamada para kling-4.0-image quando precisar de algo que o O3 não consegue fazer: 8K, uma série consistente, um prompt longo ou um design de página. Por exemplo:
- Storyboards e ângulos de produto. No O3 enviaria
n: 4e esperaria que o sujeito coincidisse. Comenable_sequential: trueo modelo planeia a série; o nosso teste manteve o mesmo motociclista, mota e roupa ao longo da madrugada, do meio-dia, do pôr do sol e da noite. - Impressão e recursos com muitos recortes. Tudo acima de 4K.
- Prompts longos e estruturados. Guias de marca, listas de planos e blocos de texto com mais de 2,000 caracteres.
- Páginas de ecommerce.
kling-4.0-long-imagecria a página de detalhe completa; o O3 não tem equivalente.
Mantenha o O3 para rascunhos de 1K–2K em grande volume, miniaturas e pipelines que precisam de JPEG ou WebP diretamente da API. Usar os dois não é problema: o O3 para explorar e o Kling Image 4.0 para a série final, com a mesma chave.
Diff de migração
Uma chamada de texto para imagem:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
Uma edição com um elemento. Dois campos renomeados e uma fusão de IDs de modelo:
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
Lista de verificação:
- Substitua os dois IDs de modelo do O3 por
kling-4.0-image; o modo de edição passa a decorrer deimage_urls. - Renomeie
elementsparakling_elementse juntefrontal_image_urlereference_image_urlsnum único arrayelement_input_urls, com a vista frontal primeiro e 2–4 URLs no total. Um elemento do O3 com uma só vista precisa de pelo menos mais uma. - Remova
output_format. O esquema rejeita campos desconhecidos. - Mude
1Kpara2K; definasizeexplicitamente se dependia da predefinição16:9do O3, já que a nova predefinição éauto. - Inclua a taxa de referência nas suas estimativas de custo.
- Aumente os timeouts do cliente ou passe a usar webhooks para 8K e séries.
O polling de estado, a leitura de files[].file_url e a verificação de webhooks mantêm-se iguais. A referência completa do pedido está no guia da Kling Image 4.0 API.
E o Kling O1 Image?
O Kling O1 Image é apenas de edição (kling-o1-image-edit) em 1K ou 2K por 3.5 créditos por imagem. Trate-o como kling-o3-image-edit na tabela acima: uma edição com referência barata, sem 4K nem 8K, sem séries.
Perguntas frequentes
A Kling Image 4.0 API substitui diretamente a Kling O3 Image API?
Quase. O endpoint, a autenticação, o polling e os webhooks são os mesmos. Muda o ID de modelo, renomeia elements para kling_elements, remove output_format e passa os pedidos de 1K para 2K.
O que é mais barato, a Kling Image 4.0 API ou o Kling O3 Image? O Kling O3 Image: 3.5 créditos por imagem em 1K ou 2K e 7 em 4K, contra 13, 19 e 32 créditos em 2K, 4K e 8K para o Kling Image 4.0, que ainda acrescenta 1 crédito por referência.
O Kling O3 Image suporta 8K ou séries de imagens?
Não. O Kling O3 Image na PoYo fica-se pelos 4K e devolve 1–9 imagens independentes. O 8K e as séries com enable_sequential são funcionalidades da Kling Image 4.0 API.
Ainda posso obter JPEG da Kling Image 4.0 API? Não a partir da API: a saída é PNG. Converta após a transferência, ou mantenha os trabalhos em JPEG e WebP no Kling O3 Image.
Preciso de uma nova chave de API para a Kling Image 4.0 API?
Não. A mesma chave da PoYo funciona para kling-4.0-image, kling-4.0-long-image, kling-o3-image e todos os outros modelos.