how-tos

Kling Image 4.0 API: imagens nativas em 8K e designs de páginas web longas

Poyo.ai Team
8 min read
Share:

Kling Image 4.0 API: imagens nativas em 8K e páginas web e de e-commerce longas

Dois recursos diferenciam a Kling Image 4.0 API: um nível de resolução 8K em kling-4.0-image, o único modelo de imagem na PoYo que tem esse nível, e um modelo separado, kling-4.0-long-image, que cria uma página web inteira ou uma página de detalhes de e-commerce como uma única imagem alta. Este post mostra os corpos de requisição, o que voltou quando os executamos no dia do lançamento e como lidar com os arquivos. Comece pela página do modelo Kling Image 4.0 se quiser testá-los primeiro no playground.

8K nativo com a Kling Image 4.0 API

A Kling diz no post de lançamento que o Kling Image 4.0 introduz a geração nativa de imagens em 8K, ou seja, a imagem é gerada nesse tamanho em vez de ser ampliada depois. Na PoYo é um único campo:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "A rider on a vintage motorbike crossing a desert highway at sunrise, long shadows, dust in the air, cinematic photography",
    "size": "16:9",
    "resolution": "8K",
    "n": 1
  }
}

O que uma requisição em 8K retorna

A equipe da PoYo executou esta estrutura de requisição (texto para imagem, size: "16:9", resolution: "8K", n: 1) na API de produção em 19 de novembro de 2026:

ResultadoValor
SaídaPNG de 10880×6144
Tamanho do arquivocerca de 128 MB
Custo32 créditos ($0.16)
Do envio ao resultadocerca de 3.8 minutos
Formato de pixelRGBA (PNG com canal alfa), mesmo a imagem sendo opaca

Como referência, a documentação da PoYo lista para 1:1 os tamanhos 2048×2048 em 2K e 8192×8192 em 8K, e 5440×3072 em 16:9 para 4K, com tamanhos típicos de PNG de cerca de 7.5 MB, 27 MB e 100 MB para 2K, 4K e 8K. Nossas imagens 2K em 16:9 da mesma sessão tinham 2720×1536.

Níveis de resolução lado a lado

resolutionDimensões de exemploPreço por imagemQuando usar
2K2048×2048 (1:1), 2720×1536 (16:9, medido)13 créditos ($0.065)Web, redes sociais, rascunhos
4K5440×3072 (16:9)19 créditos ($0.095)Telas grandes, recortes moderados
8K8192×8192 (1:1), 10880×6144 (16:9, medido)32 créditos ($0.16)Impressão, outdoors, recortes fechados de um único quadro

As referências adicionam 1 crédito cada, uma vez por requisição.

Lidando com arquivos 8K no seu pipeline

Um PNG em 8K é grande demais para ser tratado como miniatura. Mudanças práticas:

  • Use callback_url. Uma requisição que leva minutos não deve manter uma requisição web aberta. A PoYo envia por POST o resultado da tarefa para a sua URL quando ela termina ou falha.
  • Faça o download via streaming para disco ou object storage. Não leia um corpo de 128 MB na memória em uma função serverless com pouca memória, e aumente o timeout de leitura do cliente HTTP.
  • Remova o canal alfa se não precisar dele. Nossos downloads foram RGBA mesmo para imagens opacas. Converter para RGB, ou para JPEG ou WebP para entrega, é uma etapa que você adiciona; a API não tem campo de formato de saída.
  • Guarde o master em 8K e sirva derivados. Gere uma vez em 8K e depois redimensione para a web. Uma segunda geração em 8K do mesmo prompt é uma imagem nova e uma nova cobrança.
  • Planeje o orçamento das séries com cuidado. O n multiplica o preço por imagem: uma série de 10 imagens em 8K custa 320 créditos ($1.60). A documentação da PoYo estima cerca de 30 minutos para uma série de 10 imagens em 8K, então esse é um caso para webhooks.

Ampliando uma imagem existente para 8K

Passe a imagem em image_urls, defina resolution como 8K e diga o que não pode mudar:

{
  "model": "kling-4.0-image",
  "input": {
    "prompt": "Recreate @Image1 at full detail. Keep the composition, subject, colors and lighting of @Image1 unchanged.",
    "image_urls": ["https://example.com/product-hero.png"],
    "resolution": "8K"
  }
}

É uma nova geração guiada pela referência, não um upscaler de pixels, então descreva tudo o que precisa ficar exatamente igual. Custo: 32 + 1 = 33 créditos ($0.165).

Páginas longas com kling-4.0-long-image

A Kling descreve a geração em formato longo para páginas de detalhes de produto de e-commerce e web design, entregando um layout completo em uma única imagem. Na PoYo é um ID de modelo separado com um campo skill. A saída é um PNG com 1024 px de largura em 1K ou 2048 px em 2K, com a altura definida pelo conteúdo.

Designs de páginas web

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "A landing page for a specialty coffee roastery: hero with coffee beans, story section, three featured blends with prices, brewing guide, customer reviews and footer. Warm earthy palette. All text on the page is in English.",
    "skill": "webpage",
    "resolution": "1K"
  }
}

Entradas opcionais para webpage:

CampoTag no promptEfeito
style_image_url@StyleImageO design segue o estilo visual e de layout dela
subject_image_url@SubjectImageO design é construído em torno do objeto que ela mostra

O que medimos: uma requisição webpage em 1K retornou uma página de 1024×4257, a 110 créditos ($0.55), em cerca de 1.7 a 2.2 minutos (API de produção da PoYo, 19 de novembro de 2026).

Informe o idioma do texto da página

Essa é a única coisa a adicionar em todo prompt de imagem longa. No nosso teste, a primeira requisição de página web usou um prompt em inglês que não dizia em qual idioma o texto da página deveria estar, e a página voltou com texto em chinês. Adicionar a frase "All text on the page is in English." ao prompt resolveu na execução seguinte. Como cada nova execução é uma cobrança completa (110 créditos por uma página web em 1K), coloque a linha de idioma no seu template de prompt desde o início, para o idioma que a sua página precisar. A Kling lista inglês, chinês simplificado e tradicional, japonês, coreano, espanhol e português para a renderização de texto.

Páginas de detalhes de e-commerce

skill: "ecommerce" monta uma página de detalhes de produto a partir de 1 a 3 fotos de produto, referenciadas como @Image1 a @Image3:

{
  "model": "kling-4.0-long-image",
  "input": {
    "prompt": "Design a product detail page for the insulated water bottle in @Image1: hero shot, key features, capacity and size, materials, and lifestyle scenes. All text on the page is in English.",
    "skill": "ecommerce",
    "image_urls": ["https://example.com/water-bottle.png"],
    "length": "medium",
    "resolution": "1K"
  }
}

length define quantas seções a página tem, e o preço:

lengthSeções (aprox.)1K2K
short2–547 créditos ($0.235)57 créditos ($0.285)
medium (padrão)6–1094 créditos ($0.47)110 créditos ($0.55)
long11–18157 créditos ($0.785)173 créditos ($0.865)

Cada foto de produto adiciona 1 crédito. A documentação da PoYo dá uma página long em 2K como exemplo de quão altas elas ficam: até 2048×54,941 px, cerca de 87 MB.

Exibindo e fatiando imagens longas

Uma página com 1024 px de largura e vários milhares de pixels de altura não cabe em uma pré-visualização de imagem normal. Fatie-a em seções ou em blocos da altura da tela para revisão, e guarde o original para download. Trate o resultado como um mockup de design: textos, preços e botões são pixels, não HTML.

Checklist de prompts para 8K e páginas longas

  • Informe o idioma de qualquer texto na imagem.
  • Nas páginas, liste as seções em ordem: hero, recursos, especificações, avaliações, rodapé.
  • Coloque o texto exato entre aspas e diga onde ele fica; a Kling diz que o modelo renderiza até 2,000 caracteres por imagem.
  • Em 8K, descreva as texturas e os detalhes finos que você quer que sobrevivam a um recorte.
  • Nas referências, dê uma função a cada tag: "@Image1 is the product, keep its shape and label".

Referência completa de requisições e código de polling: guia da Kling Image 4.0 API. Custos: preços da Kling Image 4.0 API. Contexto sobre os dois IDs de modelo: o que é o Kling Image 4.0.

Perguntas frequentes

A Kling Image 4.0 API gera mesmo em 8K? Sim. Com resolution: "8K", nosso teste 16:9 retornou um PNG de 10880×6144, e a documentação da PoYo lista 8192×8192 em 1:1. A Kling descreve isso como geração nativa em 8K.

Quanto tempo leva uma requisição em 8K à Kling Image 4.0 API? Cerca de 3.8 minutos para uma imagem 16:9 em 8K no nosso teste do dia do lançamento. Séries maiores levam muito mais tempo, então use callback_url.

Quanto custa uma imagem em 8K com a Kling Image 4.0 API? 32 créditos ($0.16) por imagem na PoYo, mais 1 crédito por referência.

Quais tamanhos a API de imagem longa do Kling Image 4.0 retorna? 1024 px de largura em 1K ou 2048 px em 2K; a altura acompanha o conteúdo. Nossa página web em 1K tinha 1024×4257.

Por que o texto da minha página longa do Kling Image 4.0 está no idioma errado? O prompt não informou nenhum. Adicione uma linha como "All text on the page is in English."

Share: