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 desenvolvedores acesso ao modelo de imagem mais recente da Kling AI por meio 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 e-commerce. Esta página explica o que é o Kling Image 4.0, o que cada campo da requisição faz, 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. Ele foi lançado em 17 de novembro de 2026. No post 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;
  • renderiza até 2,000 caracteres de texto em uma 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 detalhes de produto de e-commerce e web design.

A Kling também diz que o modelo está disponível no Kling Creative Studio e via API para empresas e desenvolvedores. 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 você usa para todos os outros modelos da PoYo.

IDs de modelo da Kling Image 4.0 API na PoYo

ID de modeloUse 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 detalhes de produto com skill: "ecommerce" a partir de 1–3 fotos de produtoUma imagem alta, com 1024 px (1K) ou 2048 px (2K) de largura

Os dois IDs usam o mesmo endpoint de envio, o mesmo polling de tarefas e o mesmo webhook callback_url. O slug da landing page é kling-4-0-image; os IDs de modelo na requisição usam pontos (kling-4.0-image).

Endpoint e estrutura da requisição

Toda requisição à 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 na 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.

Uma requisição mínima em 4K, copiada 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 retorna as imagens em data.files, cada uma com file_url e file_type: "image". As séries de imagens voltam em ordem. Verifique o campo code no corpo além do status HTTP: a PoYo pode retornar HTTP 200 com code: 400 em um 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

CampoValoresObservações
prompt1–50,000 caracteresObrigatório. Refira-se às entradas como @Image1, @Element1
image_urls1–10 URLsAtiva imagem para imagem. Cada imagem com 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. Exige image_urls. Imagens mais elementos ≤ 10
sizeauto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9Padrão auto
resolution2K, 4K, 8KPadrão 2K. 8K é 8192×8192 em 1:1
enable_sequentialtrue / falsetrue retorna uma série de imagens coerente
n1–9 (independentes) ou 2–10 (série)Padrões 1 e 4

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

kling-4.0-long-image

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

Cada requisição de imagem longa retorna 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 tem sucesso.

RequisiçãoCré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 requisição1$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

O detalhamento de preços traz as tabelas de imagens longas e exemplos calculados.

O que medimos no dia do lançamento

A equipe da PoYo executou estas requisições na API de produção em 19 de novembro de 2026. Os tempos vão do envio ao resultado, como vistos por um cliente fazendo polling, então considere-os aproximados.

RequisiçãoSaí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, mesmo piloto, moto e roupa do amanhecer à 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 observações de integração do mesmo teste. Os downloads foram arquivos PNG com canal alfa (RGBA) mesmo para imagens opacas, então converta explicitamente se o seu pipeline espera RGB ou JPEG. E um prompt longo de página web em inglês que não informava o idioma do texto da página voltou com texto em chinês; adicionar "All text on the page is in English." resolveu. Mais sobre os dois pontos em 8K e imagens longas.

Quais requisições 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 um personagem ou produto precisa se manter igual em todos os quadros: use enable_sequential.
  • Colocar um produto ou personagem conhecido em uma cena nova: passe a cena em image_urls e o objeto principal como elemento com vários ângulos.
  • Mockups de landing pages e páginas de detalhes de e-commerce como uma única imagem: kling-4.0-long-image.

Para rascunhos rápidos em 1K–2K pelo menor preço, o Kling O3 Image é mais barato por imagem; veja Kling Image 4.0 API vs Kling O3 Image. Para 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 e-commerce). Os dois 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 requisição. Imagens longas custam de 47 a 173 créditos por página. Tarefas com falha 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 elas no prompt como @Image1, @Image2. Adicione até 7 kling_elements para personagens ou objetos consistentes; imagens mais elementos têm limite de 10.

Quanto tempo leva uma requisição à Kling Image 4.0 API? No nosso teste do dia do lançamento, uma imagem 16:9 em 8K levou 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 uma requisição aberta em trabalhos grandes.

Onde fica 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 configurações.

Share: