
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 imágenes 8K nativas, tipografía y conjuntos coherentes

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"}}'
Capacidades principales de Kling Image 4.0


Hasta 2000 caracteres de texto multilingüe

Conjuntos coherentes de hasta 10 imágenes

Hasta 10 imágenes de referencia y elementos personalizados

Diseños visuales en formato largo para comercio electrónico y páginas web

Arquitectura unificada y compatibilidad con prompts detallados
Parámetros de la API de kling-4-0/image en Kie.ai
Parámetros para POST /api/v1/jobs/createTask cuando model está configurado en kling-4-0/image.
| Parameter | Valores y reglas |
|---|---|
| model | kling-4-0/image |
| prompt | Obligatorio; hasta 20 000 caracteres en la API y el playground (pon entre comillas el texto dentro de la imagen; cita @image_1… y @name) |
| image_urls | Opcional; hasta 10 URL de imágenes (JPG, JPEG o PNG; máx. 20 MB cada una; relación de aspecto entre 2:5 y 5:2; lado más largo de hasta 8192 px) |
| elements | Sujetos personalizados opcionales ({name, image_urls[2..4], tag, description}); image_urls + elements ≤ 10 |
| mode | default (predeterminado) o series (conjunto coherente de imágenes) |
| count | De 1 a 9 en el modo default (predeterminado 1); obligatorio de 2 a 10 en el modo series |
| resolution | 2k (predeterminado), 4k u 8k (2k/4k suelen devolver PNG; 8k devuelve JPEG) |
| aspect_ratio | auto (predeterminado), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
Parámetros de la API kling-4-0/long-image en Kie.ai
Parámetros para POST /api/v1/jobs/createTask cuando model está configurado en kling-4-0/long-image (genera 1 imagen larga por tarea; no mezcles campos de distintos valores de skill).
| Parameter | Valores y reglas |
|---|---|
| model | kling-4-0/long-image |
| skill | Obligatorio: ecommerce (página de detalles de producto) o webpage (diseño de página web) |
| prompt | Obligatorio; hasta 20 000 caracteres (cita @image_1… en ecommerce; @style y @subject en webpage) |
| image_urls | Obligatorio solo para ecommerce: de 1 a 3 URL de imágenes de producto (JPG, JPEG o PNG; máx. 20 MB cada una; la relación de aspecto debe estar entre 2:5 y 5:2, de lo contrario la tarea fallará) |
| length | Solo para comercio electrónico: corta (unas 2–5 secciones), media (unas 6–10 secciones, predeterminada) o larga (unas 11–18 secciones) en una sola imagen larga |
| style_image, subject_image | Solo para páginas web: URLs opcionales de JPG, JPEG o PNG (máximo 20 MB cada una), citadas como @style y @subject |
| resolution | 1k o 2k (2k de forma predeterminada) |
Cómo usar la Kling Image 4.0 API en Kie.ai
- 1
Paso 1: prueba en el entorno de pruebas o elige un punto de conexión
Prueba instrucciones en el entorno de pruebas de esta página. Usa kling-4-0/image para imágenes estáticas en 2K, 4K y 8K, ediciones con referencias y conjuntos de 2 a 10 imágenes, o kling-4-0/long-image para páginas de detalles de productos de comercio electrónico y diseños de páginas web en una sola imagen. - 2
Paso 2: estructura las instrucciones, las referencias y las citas
Pon entre comillas cualquier texto que deba aparecer en la imagen. Cita image_urls en orden como @image_1, @image_2 y los elements de sujetos personalizados como @name en kling-4-0/image, o usa @style y @subject en las tareas de imágenes largas para páginas web. - 3
Paso 3: crea una tarea de generación
Envía una solicitud POST a https://api.kie.ai/api/v1/jobs/createTask con una cabecera Authorization: Bearer YOUR_API_KEY. Asigna a model el punto de conexión elegido, añade callBackUrl si lo necesitas e incluye las instrucciones obligatorias en prompt y los ajustes compatibles dentro de input: usa aspect_ratio y mode con kling-4-0/image e incluye el campo obligatorio skill para kling-4-0/long-image. - 4
Paso 4: obtén las URLs de las imágenes generadas
Recibe notificaciones webhook de finalización en callBackUrl o consulta periódicamente GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=... para leer resultUrls. Con kling-4-0/image, los resultados en 2K y 4K suelen usar PNG, mientras que los resultados en 8K usan JPEG.