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 ecommerce longas

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:

ResultadoValor
SaídaPNG de 10880×6144
Tamanho do ficheirocerca de 128 MB
Custo32 créditos ($0.16)
Da submissão ao resultadocerca de 3.8 minutos
Formato de píxelRGBA (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

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)Ecrãs grandes, recortes moderados
8K8192×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 n multiplica 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:

CampoEtiqueta no promptEfeito
style_image_url@StyleImageO design segue o seu estilo visual e de layout
subject_image_url@SubjectImageO 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:

lengthSecções (aprox.)1K2K
short2–547 créditos ($0.235)57 créditos ($0.285)
medium (predefinição)6–1094 créditos ($0.47)110 créditos ($0.55)
long11–18157 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: "@Image1 is 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."

Share: