guides

Kling Image 4.0 API: o que é o Kling Image 4.0, IDs de modelo e preços

Poyo.ai Team
9 min read
Share:

Kling Image 4.0 API na PoYo: imagens nativas em 8K, séries de imagens e designs de páginas longas

A Kling Image 4.0 API dá aos programadores acesso ao modelo de imagem mais recente da Kling AI através de um único endpoint da PoYo: chame kling-4.0-image para texto para imagem, edição e séries de imagens em 2K, 4K ou 8K, e kling-4.0-long-image para designs completos de páginas web ou de ecommerce. Esta página explica o que é o Kling Image 4.0, o que faz cada campo do pedido, quais são os limites e quanto custa uma chamada na PoYo.

O que é o Kling Image 4.0?

O Kling Image 4.0 é o modelo de imagem da família Kling 4.0 da Kling AI, a plataforma criativa de IA da Kuaishou. Foi lançado a 17 de novembro de 2026. Na sua publicação de lançamento, a Kling afirma que o modelo:

  • gera imagens em 8K nativo, que a Kling introduz pela primeira vez com este modelo;
  • cria até 10 imagens a partir de um prompt com estilo e conteúdo consistentes;
  • apresenta até 2,000 caracteres de texto numa imagem, em inglês, chinês simplificado, chinês tradicional, japonês, coreano, espanhol e português;
  • produz imagens em formato longo para páginas de detalhe de produto de ecommerce e web design.

A Kling indica ainda que o modelo está disponível no Kling Creative Studio e via API para empresas e programadores. A PoYo adicionou a Kling Image 4.0 API em novembro de 2026, sem lista de espera e com a mesma chave de API que usa para todos os outros modelos da PoYo.

IDs de modelo da Kling Image 4.0 API na PoYo

ID de modeloUse-o paraSaída
kling-4.0-imageTexto para imagem (sem image_urls), imagem para imagem com 1–10 referências, elementos, séries de imagens1–9 imagens independentes, ou uma série de 2–10, em 2K / 4K / 8K
kling-4.0-long-imageDesigns de página com skill: "webpage", páginas de detalhe de produto com skill: "ecommerce" a partir de 1–3 fotografias de produtoUma imagem alta, com 1024 px (1K) ou 2048 px (2K) de largura

Ambos os IDs usam o mesmo endpoint de submissão, o mesmo polling de tarefas e o mesmo webhook callback_url. O slug da landing page é kling-4-0-image; os IDs de modelo no pedido usam pontos (kling-4.0-image).

Endpoint e estrutura do pedido

Cada pedido à Kling Image 4.0 API é uma tarefa assíncrona:

  1. POST https://api.poyo.ai/api/generate/submit com Authorization: Bearer $POYO_API_KEY e um corpo JSON com model e input.
  2. Leia data.task_id da resposta.
  3. Consulte GET https://api.poyo.ai/api/generate/status/{task_id} até status ser finished ou failed, ou passe callback_url no nível superior e receba um POST quando a tarefa terminar.

Um pedido mínimo em 4K, copiado da estrutura da documentação:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
    "size": "16:9",
    "resolution": "4K"
  }
}

Uma tarefa concluída devolve as imagens em data.files, cada uma com file_url e file_type: "image". As séries de imagens são devolvidas por ordem. Verifique o campo code no corpo, além do estado HTTP: a PoYo pode devolver HTTP 200 com code: 400 num erro de validação. A versão passo a passo com cURL e Python está no guia da Kling Image 4.0 API.

Campos de entrada e limites

kling-4.0-image

CampoValoresNotas
prompt1–50,000 caracteresObrigatório. Refira-se às entradas como @Image1, @Element1
image_urls1–10 URLsAtiva imagem para imagem. Cada imagem até 30 MB, pelo menos 300 px por lado, proporção 0.4–2.5
kling_elementsaté 7 elementosCada um {"element_input_urls": [...]} com 2–4 vistas, a frontal primeiro. Requer image_urls. Imagens mais elementos ≤ 10
sizeauto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9Predefinição auto
resolution2K, 4K, 8KPredefinição 2K. 8K é 8192×8192 em 1:1
enable_sequentialtrue / falsetrue devolve uma série de imagens coerente
n1–9 (independentes) ou 2–10 (série)Predefinições 1 e 4

O esquema rejeita campos desconhecidos, por isso não envie output_format, seed nem negative_prompt. A saída é PNG.

kling-4.0-long-image

CampoValoresNotas
skillwebpage (predefinição), ecommerceEscolhe o tipo de página
image_urls1–3 fotografias de produtoObrigatório para ecommerce
style_image_url / subject_image_urlum URL cadaSó webpage; @StyleImage, @SubjectImage
lengthshort, medium (predefinição), longSó ecommerce: cerca de 2–5, 6–10 ou 11–18 secções
resolution1K (predefinição), 2KLargura de 1024 ou 2048 px; a altura acompanha o conteúdo

Cada pedido de imagem longa devolve uma imagem.

Preços da Kling Image 4.0 API na PoYo

A PoYo cobra por imagem gerada (1 crédito = $0.005). Os créditos só são cobrados quando a tarefa é bem-sucedida.

PedidoCréditosUSD
kling-4.0-image, 2K, por imagem13$0.065
kling-4.0-image, 4K, por imagem19$0.095
kling-4.0-image, 8K, por imagem32$0.16
Cada item de image_urls e cada elemento de kling_elements, uma vez por pedido1$0.005
Imagem longa, webpage, 1K / 2K110 / 120$0.55 / $0.60
Imagem longa, ecommerce short, 1K / 2K47 / 57$0.235 / $0.285
Imagem longa, ecommerce medium, 1K / 2K94 / 110$0.47 / $0.55
Imagem longa, ecommerce long, 1K / 2K157 / 173$0.785 / $0.865
Imagem longa, cada imagem em image_urls, style_image_url ou subject_image_url1$0.005

A análise de preços inclui as tabelas das imagens longas e exemplos calculados.

O que medimos no dia do lançamento

A equipa da PoYo executou estes pedidos na API de produção a 19 de novembro de 2026. Os tempos vão da submissão ao resultado, tal como os vê um cliente que faz polling, por isso considere-os aproximados.

PedidoSaídaCustoTempo
kling-4.0-image, texto para imagem, 16:9, 8K, n: 1PNG de 10880×6144, cerca de 128 MB32 créditoscerca de 3.8 min
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4quatro imagens de 2720×1536, o mesmo motociclista, mota e roupa da madrugada à noite52 créditoscerca de 4.9 min
kling-4.0-long-image, skill: "webpage", 1Kuma página de 1024×4257110 créditoscerca de 1.7–2.2 min

Duas notas de integração do mesmo teste. As transferências foram ficheiros PNG com canal alfa (RGBA) mesmo para imagens opacas, por isso converta explicitamente se o seu pipeline espera RGB ou JPEG. E um prompt longo de página web em inglês que não indicava o idioma do texto da página veio com texto em chinês; acrescentar "All text on the page is in English." resolveu. Mais sobre ambos em 8K e imagens longas.

Que pedidos devem ir para a Kling Image 4.0 API?

  • Impressão, outdoors e trabalhos com muitos recortes que precisam de mais de 4K: é o único modelo de imagem na PoYo com um nível 8K.
  • Storyboards, ângulos de produto e apresentações em que uma personagem ou produto tem de se manter igual em todos os fotogramas: use enable_sequential.
  • Colocar um produto ou personagem conhecido numa cena nova: passe a cena em image_urls e o sujeito como um elemento com vários ângulos.
  • Mockups de landing pages e páginas de detalhe de ecommerce como uma única imagem: kling-4.0-long-image.

Para rascunhos rápidos em 1K–2K ao preço mais baixo, o Kling O3 Image é mais barato por imagem; veja Kling Image 4.0 API vs Kling O3 Image. Para o comparar com outros fornecedores, leia Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.

Perguntas frequentes

O que é a Kling Image 4.0 API? É o acesso REST da PoYo ao modelo Kling Image 4.0 da Kling AI, com os IDs de modelo kling-4.0-image (imagens padrão, edições e séries de imagens) e kling-4.0-long-image (páginas web longas e páginas de ecommerce). Ambos usam POST /api/generate/submit e a mesma chave de API.

Quanto custa a Kling Image 4.0 API? 13 créditos ($0.065) por imagem em 2K, 19 créditos ($0.095) em 4K e 32 créditos ($0.16) em 8K, mais 1 crédito ($0.005) por imagem de referência ou elemento, uma vez por pedido. As imagens longas custam de 47 a 173 créditos por página. As tarefas falhadas não são cobradas.

A Kling Image 4.0 API suporta imagem para imagem? Sim. Passe de 1 a 10 URLs em image_urls com kling-4.0-image e refira-se a eles no prompt como @Image1, @Image2. Adicione até 7 kling_elements para personagens ou objetos consistentes; imagens mais elementos estão limitados a 10.

Quanto tempo demora um pedido à Kling Image 4.0 API? No nosso teste do dia do lançamento, uma imagem 16:9 em 8K demorou cerca de 3.8 minutos, uma série de quatro imagens em 2K cerca de 4.9 minutos e uma página web em 1K cerca de 2 minutos. Use callback_url em vez de manter um pedido aberto em trabalhos grandes.

Onde está a documentação da Kling Image 4.0 API? A referência dos campos está na documentação do Kling Image 4.0 e na documentação de imagens longas. A página do modelo tem um playground que mostra o JSON das suas definições.

Share: