
Duas funcionalidades distinguem 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 o tem, e um modelo separado, kling-4.0-long-image, que desenha uma página web completa ou uma página de detalhe de ecommerce como uma única imagem alta. Este artigo mostra os corpos de pedido, o que recebemos quando os executámos no dia do lançamento e como tratar os ficheiros. Comece pela página do modelo Kling Image 4.0 se quiser experimentá-los primeiro no playground.
8K nativo com a Kling Image 4.0 API
A Kling afirma na sua publicação 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 só 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 devolve um pedido em 8K
A equipa da PoYo executou esta estrutura de pedido (texto para imagem, size: "16:9", resolution: "8K", n: 1) na API de produção a 19 de novembro de 2026:
| Resultado | Valor |
|---|---|
| Saída | PNG de 10880×6144 |
| Tamanho do ficheiro | cerca de 128 MB |
| Custo | 32 créditos ($0.16) |
| Da submissão ao resultado | cerca de 3.8 minutos |
| Formato de píxel | RGBA (PNG com canal alfa), embora a imagem seja opaca |
Como referência, a documentação da PoYo indica 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. As 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) | Ecrãs grandes, recortes moderados |
8K | 8192×8192 (1:1), 10880×6144 (16:9, medido) | 32 créditos ($0.16) | Impressão, outdoors, recortes apertados de um único fotograma |
As referências acrescentam 1 crédito cada, uma vez por pedido.
Tratar ficheiros 8K no seu pipeline
Um PNG em 8K é grande demais para ser tratado como uma miniatura. Alterações práticas:
- Use
callback_url. Um pedido que demora minutos não deve manter um pedido web aberto. A PoYo envia por POST o resultado da tarefa para o seu URL quando termina ou falha. - Transfira por streaming para disco ou armazenamento de objetos. Não leia um corpo de 128 MB para memória numa 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. As nossas transferências foram RGBA mesmo para imagens opacas. Converter para RGB, ou para JPEG ou WebP para entrega, é um passo que acrescenta do seu lado; 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.
- Orçamente as séries com cuidado. O
nmultiplica o preço por imagem: uma série de 10 imagens em 8K são 320 créditos ($1.60). A documentação da PoYo aponta cerca de 30 minutos para uma série de 10 imagens em 8K, por isso este é um caso para webhooks.
Ampliar 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"
}
}
Trata-se de uma nova geração guiada pela referência, não de um ampliador de píxeis, por isso descreva tudo o que tem de 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 detalhe de produto de ecommerce e web design, entregando um layout completo numa ú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 | Etiqueta no prompt | Efeito |
|---|---|---|
style_image_url | @StyleImage | O design segue o seu estilo visual e de layout |
subject_image_url | @SubjectImage | O design é construído em torno do sujeito que mostra |
O que medimos: um pedido webpage em 1K devolveu 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).
Indique o idioma do texto da página
É a única coisa a acrescentar a todos os prompts de imagem longa. No nosso teste, o primeiro pedido de página web usou um prompt em inglês que não dizia em que idioma devia estar o texto da página, e a página veio com texto em chinês. Acrescentar 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), inclua a linha de idioma no seu modelo de prompt desde o início, para o idioma de que a sua página precisar. A Kling enumera inglês, chinês simplificado e tradicional, japonês, coreano, espanhol e português para a apresentação de texto.
Páginas de detalhe de ecommerce
skill: "ecommerce" cria uma página de detalhe de produto a partir de 1 a 3 fotografias 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 secções a página tem, e o preço:
length | Secções (aprox.) | 1K | 2K |
|---|---|---|---|
short | 2–5 | 47 créditos ($0.235) | 57 créditos ($0.285) |
medium (predefiniçã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 fotografia de produto acrescenta 1 crédito. A documentação da PoYo dá uma página long em 2K como exemplo de quão altas podem ser: até 2048×54,941 px, cerca de 87 MB.
Mostrar e dividir imagens longas
Uma página com 1024 px de largura e vários milhares de píxeis de altura não cabe numa pré-visualização de imagem normal. Divida-a em secções ou em blocos com a altura do ecrã para revisão, e guarde o original para transferência. Trate o resultado como um mockup de design: os textos, os preços e os botões são píxeis, não HTML.
Lista de verificação de prompts para 8K e páginas longas
- Indique o idioma de qualquer texto na imagem.
- Nas páginas, enumere as secções por ordem: hero, funcionalidades, especificações, avaliações, rodapé.
- Coloque o texto exato entre aspas e diga onde fica; a Kling afirma que o modelo apresenta até 2,000 caracteres por imagem.
- Em 8K, descreva as texturas e os detalhes finos que quer que sobrevivam a um recorte.
- Nas referências, dê a cada etiqueta uma função: "
@Image1is the product, keep its shape and label".
Referência completa de pedidos 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", o nosso teste 16:9 devolveu um PNG de 10880×6144, e a documentação da PoYo indica 8192×8192 em 1:1. A Kling descreve isto como geração nativa em 8K.
Quanto tempo demora um pedido 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. As séries maiores demoram muito mais, por isso 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.
Que tamanhos devolve a API de imagem longa do Kling Image 4.0?
1024 px de largura em 1K ou 2048 px em 2K; a altura acompanha o conteúdo. A nossa página web em 1K tinha 1024×4257.
Porque é que o texto da minha página longa do Kling Image 4.0 está no idioma errado? O prompt não indicava nenhum. Acrescente uma linha como "All text on the page is in English."