
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:
| Resultado | Valor |
|---|---|
| Saída | PNG de 10880×6144 |
| Tamanho do arquivo | cerca de 128 MB |
| Custo | 32 créditos ($0.16) |
| Do envio ao resultado | cerca de 3.8 minutos |
| Formato de pixel | RGBA (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
resolution | Dimensões de exemplo | Preço por imagem | Quando usar |
|---|---|---|---|
2K | 2048×2048 (1:1), 2720×1536 (16:9, medido) | 13 créditos ($0.065) | Web, redes sociais, rascunhos |
4K | 5440×3072 (16:9) | 19 créditos ($0.095) | Telas grandes, recortes moderados |
8K | 8192×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
nmultiplica 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:
| Campo | Tag no prompt | Efeito |
|---|---|---|
style_image_url | @StyleImage | O design segue o estilo visual e de layout dela |
subject_image_url | @SubjectImage | O 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:
length | Seções (aprox.) | 1K | 2K |
|---|---|---|---|
short | 2–5 | 47 créditos ($0.235) | 57 créditos ($0.285) |
medium (padrão) | 6–10 | 94 créditos ($0.47) | 110 créditos ($0.55) |
long | 11–18 | 157 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: "
@Image1is 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."