
Required. E-commerce: reference product images as @image_1, @image_2 ... Webpage: reference the style image as @style and the subject image as @subject. Any @ followed by letters/digits/underscore/Chinese is treated as a reference; use a full-width @ or add a space after @ for emails or handles.
0/20000ecommerce: product detail page (1-3 product images required). webpage: web page design (optional style and subject images).
Click to upload or drag and drop
Supported formats: PNG, JPEG Maximum file size: 20MB; Maximum files: 3
E-commerce only. 1-3 product images, referenced in the prompt as @image_1, @image_2 ... in upload order. Recommended: width and height >= 300px, aspect ratio between 2:5 and 5:2.
E-commerce only. short: about 2-5 sections; medium: about 6-10 sections; long: about 11-18 sections. Sections are content blocks within one long image, not separate images.
Output resolution.

Explore different use cases and parameter configurations
Text prompt (required). Reference uploaded images as @image_1, @image_2 ... in upload order, and elements as @name. Put any text that should appear in the image inside quotation marks.
0/20000Click to upload or drag and drop
Supported formats: PNG, JPEG Maximum file size: 20MB; Maximum files: 10
Optional reference images (up to 10). Leave empty for text-to-image; upload images for image-to-image and reference them in the prompt as @image_1, @image_2 ...
Optional subjects created for this task, referenced in the prompt as @name. Each element needs 2-4 images. image_urls and elements together cannot exceed 10.
default: standard generation (1-9 images). series: generate a coherent set of 2-10 images.
Output resolution.
Aspect ratio of the output image.
Number of images. Default mode: 1-9 (default 1). Series mode: 2-10, required.

Explore different use cases and parameter configurations
README
Complete guide to using Kling Image 4.0
Kling Image 4.0 API para Imagens 8K Nativas, Tipografia e Conjuntos Coesos

curl https://api.kie.ai/api/v1/jobs/createTask \-H "Authorization: Bearer $KIE_API_KEY" \-H "Content-Type: application/json" \-d '{"model": "kling-4-0/image","input": {"prompt": "A faceted glass perfume bottle on wet slate, studio lighting","resolution": "2k","aspect_ratio": "16:9"}}'
Principais Recursos do Kling Image 4.0


Até 2.000 Caracteres de Texto Multilíngue

Conjuntos Coesos de Até 10 Imagens

Até 10 Imagens de Referência e elements Personalizados

Imagens Extensas para Comércio Eletrônico e Páginas Web

Arquitetura Unificada e Suporte a Comandos Detalhados
Parâmetros da API kling-4-0/image no Kie.ai
Parâmetros de POST /api/v1/jobs/createTask quando model está definido como kling-4-0/image.
| Parameter | Valores e regras |
|---|---|
| model | kling-4-0/image |
| prompt | Obrigatório; até 20.000 caracteres na API e no ambiente de testes (coloque entre aspas o texto da imagem; cite @image_1… e @name) |
| image_urls | Opcional; até 10 URLs de imagens (JPG, JPEG ou PNG; máximo de 20 MB cada; proporção entre 2:5 e 5:2; lado maior de até 8.192 px) |
| elements | Sujeitos personalizados opcionais ({name, image_urls[2..4], tag, description}); image_urls + elements ≤ 10 |
| mode | default (padrão) ou series (conjunto coeso de imagens) |
| count | 1 a 9 no modo default (padrão: 1); obrigatório de 2 a 10 no modo series |
| resolution | 2k (padrão), 4k ou 8k (2k/4k geralmente retornam PNG; 8k retorna JPEG) |
| aspect_ratio | auto (padrão), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
Parâmetros da API kling-4-0/long-image no Kie.ai
Parâmetros de POST /api/v1/jobs/createTask quando model está definido como kling-4-0/long-image (gera 1 imagem longa por tarefa; não misture campos de diferentes valores de skill).
| Parameter | Valores e regras |
|---|---|
| model | kling-4-0/long-image |
| skill | Obrigatório: ecommerce (página de detalhes do produto) ou webpage (design de página web) |
| prompt | Obrigatório; até 20.000 caracteres (cite @image_1… em ecommerce; @style e @subject em webpage) |
| image_urls | Obrigatório apenas para ecommerce: 1 a 3 URLs de imagens de produto (JPG, JPEG ou PNG; máximo de 20 MB cada; a proporção deve estar entre 2:5 e 5:2, caso contrário, a tarefa falha) |
| length | somente e-commerce: curto (cerca de 2 a 5 seções), médio (cerca de 6 a 10 seções, padrão) ou longo (cerca de 11 a 18 seções) em uma única imagem longa |
| style_image, subject_image | somente página da web: URLs opcionais em JPG, JPEG ou PNG (máximo de 20 MB cada), citadas como @style e @subject |
| resolution | 1k ou 2k (padrão 2k) |
Como Usar a Kling Image 4.0 API no Kie.ai
- 1
Passo 1: Teste no Playground ou Escolha um Endpoint
Experimente prompts no playground nesta página. Use kling-4-0/image para imagens estáticas em 2K, 4K e 8K, edições de referência e conjuntos de 2 a 10 imagens, ou kling-4-0/long-image para páginas de detalhes de e-commerce de saída única e designs de páginas da web. - 2
Passo 2: Estruture Prompts, Referências e Citações
Coloque qualquer texto a ser renderizado entre aspas. Cite os image_urls em ordem como @image_1, @image_2 e os elements de sujeito personalizados como @name em kling-4-0/image, ou use @style e @subject em tarefas de imagem longa de página web. - 3
Passo 3: Crie uma Tarefa de Geração
Envie uma requisição POST para https://api.kie.ai/api/v1/jobs/createTask com um cabeçalho Authorization: Bearer YOUR_API_KEY. Defina o campo model como o endpoint escolhido, adicione opcionalmente callBackUrl e inclua o prompt obrigatório e as configurações suportadas em input: use aspect_ratio e mode com kling-4-0/image, e inclua o campo obrigatório skill para kling-4-0/long-image. - 4
Passo 4: Recupere as URLs das Imagens Geradas
Receba webhooks de conclusão em callBackUrl ou consulte GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=... para ler resultUrls. Para kling-4-0/image, as saídas em 2K e 4K geralmente usam PNG, enquanto as saídas em 8K usam JPEG.