comparisons

Kling Image 4.0 API vs Kling O3 Image API: quando mudar

Poyo.ai Team
8 min read
Share:

Kling Image 4.0 API vs Kling O3 Image API na PoYo

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 imagemkling-o3-image / kling-o3-image-edit
JPEG ou WebP diretamente da APIKling O3 Image (output_format)
Mais de 4K, ou exatamente 8Kkling-4.0-image
Uma série de 2–10 imagens com o mesmo sujeito e estilokling-4.0-image com enable_sequential
Prompts com mais de 2,000 caractereskling-4.0-image (até 50,000)
Uma página web completa ou página de detalhe de ecommerce como uma única imagemkling-4.0-long-image
Texto para imagem e edição num só ID de modelokling-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.

CampoKling O3 ImageKling Image 4.0 API
modelkling-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
promptaté 2,000 caracteres1–50,000 caracteres
image_urls1–10, obrigatório para kling-o3-image-edit1–10 (opcional); 30 MB, ≥300 px, proporção 0.4–2.5 cada
Elementoselements: [{frontal_image_url, reference_image_urls}]kling_elements: [{element_input_urls: [front, …]}], 2–4 vistas, até 7, imagens + elementos ≤ 10
resolution1K (predefinição), 2K, 4K2K (predefinição), 4K, 8K
size8 proporções, predefinição 16:9; auto só no modelo de ediçãoas mesmas 8 proporções mais auto, predefinição auto
output_formatjpeg, png (predefinição), webpnão aceite; só PNG
n1–91–9 independentes, ou 2–10 com enable_sequential: true
enable_sequentialnão disponíveltrue devolve uma série ordenada e consistente
Páginas longasnão disponívelmodelo 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 pedidoKling O3 ImageKling Image 4.0 API
1 imagem, 1K3.5 créditos ($0.0175)não disponível (mínimo 2K: 13 créditos)
1 imagem, 2K3.5 créditos ($0.0175)13 créditos ($0.065)
1 imagem, 4K7 créditos ($0.035)19 créditos ($0.095)
1 imagem, 8Knão disponível32 créditos ($0.16)
Edição 2K, 2 imagens de referência + 1 elemento3.5 créditos ($0.0175)16 créditos ($0.08)
4 imagens em 2K14 créditos ($0.07), independentes52 créditos ($0.26), em série ou independentes
Design de página web, 1Knão disponível110 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 usava jpeg ou webp no 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: 4 e esperaria que o sujeito coincidisse. Com enable_sequential: true o 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-image cria 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:

  1. Substitua os dois IDs de modelo do O3 por kling-4.0-image; o modo de edição passa a decorrer de image_urls.
  2. Renomeie elements para kling_elements e junte frontal_image_url e reference_image_urls num único array element_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.
  3. Remova output_format. O esquema rejeita campos desconhecidos.
  4. Mude 1K para 2K; defina size explicitamente se dependia da predefinição 16:9 do O3, já que a nova predefinição é auto.
  5. Inclua a taxa de referência nas suas estimativas de custo.
  6. 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.

Share: