
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 modelo | Use para | Saída |
|---|---|---|
kling-4.0-image | Texto para imagem (sem image_urls), imagem para imagem com 1–10 referências, elementos, séries de imagens | 1–9 imagens independentes, ou uma série de 2–10, em 2K / 4K / 8K |
kling-4.0-long-image | Designs de página com skill: "webpage", páginas de detalhes de produto com skill: "ecommerce" a partir de 1–3 fotos de produto | Uma 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:
POST https://api.poyo.ai/api/generate/submitcomAuthorization: Bearer $POYO_API_KEYe um corpo JSON commodeleinput.- Leia
data.task_idna resposta. - Consulte
GET https://api.poyo.ai/api/generate/status/{task_id}atéstatusserfinishedoufailed, ou passecallback_urlno 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
| Campo | Valores | Observações |
|---|---|---|
prompt | 1–50,000 caracteres | Obrigatório. Refira-se às entradas como @Image1, @Element1 |
image_urls | 1–10 URLs | Ativa imagem para imagem. Cada imagem com até 30 MB, pelo menos 300 px por lado, proporção 0.4–2.5 |
kling_elements | até 7 elementos | Cada um {"element_input_urls": [...]} com 2–4 vistas, a frontal primeiro. Exige image_urls. Imagens mais elementos ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Padrão auto |
resolution | 2K, 4K, 8K | Padrão 2K. 8K é 8192×8192 em 1:1 |
enable_sequential | true / false | true retorna uma série de imagens coerente |
n | 1–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
| Campo | Valores | Observações |
|---|---|---|
skill | webpage (padrão), ecommerce | Escolhe o tipo de página |
image_urls | 1–3 fotos de produto | Obrigatório para ecommerce |
style_image_url / subject_image_url | uma URL cada | Só webpage; @StyleImage, @SubjectImage |
length | short, medium (padrão), long | Só ecommerce: cerca de 2–5, 6–10 ou 11–18 seções |
resolution | 1K (padrão), 2K | Largura 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ção | Créditos | USD |
|---|---|---|
kling-4.0-image, 2K, por imagem | 13 | $0.065 |
kling-4.0-image, 4K, por imagem | 19 | $0.095 |
kling-4.0-image, 8K, por imagem | 32 | $0.16 |
Cada item de image_urls e cada elemento de kling_elements, uma vez por requisição | 1 | $0.005 |
| Imagem longa, webpage, 1K / 2K | 110 / 120 | $0.55 / $0.60 |
| Imagem longa, ecommerce short, 1K / 2K | 47 / 57 | $0.235 / $0.285 |
| Imagem longa, ecommerce medium, 1K / 2K | 94 / 110 | $0.47 / $0.55 |
| Imagem longa, ecommerce long, 1K / 2K | 157 / 173 | $0.785 / $0.865 |
Imagem longa, cada imagem em image_urls, style_image_url ou subject_image_url | 1 | $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ção | Saída | Custo | Tempo |
|---|---|---|---|
kling-4.0-image, texto para imagem, 16:9, 8K, n: 1 | PNG de 10880×6144, cerca de 128 MB | 32 créditos | cerca de 3.8 min |
kling-4.0-image, 16:9, 2K, enable_sequential: true, n: 4 | quatro imagens de 2720×1536, mesmo piloto, moto e roupa do amanhecer à noite | 52 créditos | cerca de 4.9 min |
kling-4.0-long-image, skill: "webpage", 1K | uma página de 1024×4257 | 110 créditos | cerca 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_urlse 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.