
A Kling Image 4.0 API dá aos programadores acesso ao modelo de imagem mais recente da Kling AI através 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 ecommerce. Esta página explica o que é o Kling Image 4.0, o que faz cada campo do pedido, 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. Foi lançado a 17 de novembro de 2026. Na sua publicação 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;
- apresenta até 2,000 caracteres de texto numa 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 detalhe de produto de ecommerce e web design.
A Kling indica ainda que o modelo está disponível no Kling Creative Studio e via API para empresas e programadores. 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 usa para todos os outros modelos da PoYo.
IDs de modelo da Kling Image 4.0 API na PoYo
| ID de modelo | Use-o 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 detalhe de produto com skill: "ecommerce" a partir de 1–3 fotografias de produto | Uma imagem alta, com 1024 px (1K) ou 2048 px (2K) de largura |
Ambos os IDs usam o mesmo endpoint de submissão, o mesmo polling de tarefas e o mesmo webhook callback_url. O slug da landing page é kling-4-0-image; os IDs de modelo no pedido usam pontos (kling-4.0-image).
Endpoint e estrutura do pedido
Cada pedido à 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_idda 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.
Um pedido mínimo em 4K, copiado 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 devolve as imagens em data.files, cada uma com file_url e file_type: "image". As séries de imagens são devolvidas por ordem. Verifique o campo code no corpo, além do estado HTTP: a PoYo pode devolver HTTP 200 com code: 400 num 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 | Notas |
|---|---|---|
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 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. Requer image_urls. Imagens mais elementos ≤ 10 |
size | auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 | Predefinição auto |
resolution | 2K, 4K, 8K | Predefinição 2K. 8K é 8192×8192 em 1:1 |
enable_sequential | true / false | true devolve uma série de imagens coerente |
n | 1–9 (independentes) ou 2–10 (série) | Predefinições 1 e 4 |
O esquema rejeita campos desconhecidos, por isso não envie output_format, seed nem negative_prompt. A saída é PNG.
kling-4.0-long-image
| Campo | Valores | Notas |
|---|---|---|
skill | webpage (predefinição), ecommerce | Escolhe o tipo de página |
image_urls | 1–3 fotografias de produto | Obrigatório para ecommerce |
style_image_url / subject_image_url | um URL cada | Só webpage; @StyleImage, @SubjectImage |
length | short, medium (predefinição), long | Só ecommerce: cerca de 2–5, 6–10 ou 11–18 secções |
resolution | 1K (predefinição), 2K | Largura de 1024 ou 2048 px; a altura acompanha o conteúdo |
Cada pedido de imagem longa devolve 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 é bem-sucedida.
| Pedido | 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 pedido | 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 |
A análise de preços inclui as tabelas das imagens longas e exemplos calculados.
O que medimos no dia do lançamento
A equipa da PoYo executou estes pedidos na API de produção a 19 de novembro de 2026. Os tempos vão da submissão ao resultado, tal como os vê um cliente que faz polling, por isso considere-os aproximados.
| Pedido | 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, o mesmo motociclista, mota e roupa da madrugada à 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 notas de integração do mesmo teste. As transferências foram ficheiros PNG com canal alfa (RGBA) mesmo para imagens opacas, por isso converta explicitamente se o seu pipeline espera RGB ou JPEG. E um prompt longo de página web em inglês que não indicava o idioma do texto da página veio com texto em chinês; acrescentar "All text on the page is in English." resolveu. Mais sobre ambos em 8K e imagens longas.
Que pedidos 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 uma personagem ou produto tem de se manter igual em todos os fotogramas: use
enable_sequential. - Colocar um produto ou personagem conhecido numa cena nova: passe a cena em
image_urlse o sujeito como um elemento com vários ângulos. - Mockups de landing pages e páginas de detalhe de ecommerce como uma única imagem:
kling-4.0-long-image.
Para rascunhos rápidos em 1K–2K ao preço mais baixo, o Kling O3 Image é mais barato por imagem; veja Kling Image 4.0 API vs Kling O3 Image. Para o 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 ecommerce). Ambos 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 pedido. As imagens longas custam de 47 a 173 créditos por página. As tarefas falhadas 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 eles no prompt como @Image1, @Image2. Adicione até 7 kling_elements para personagens ou objetos consistentes; imagens mais elementos estão limitados a 10.
Quanto tempo demora um pedido à Kling Image 4.0 API?
No nosso teste do dia do lançamento, uma imagem 16:9 em 8K demorou 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 um pedido aberto em trabalhos grandes.
Onde está 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 definições.