
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 pour images 8K natives, typographie et séries cohérentes

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"}}'
Capacités clés de Kling Image 4.0


Jusqu'à 2 000 caractères de texte multilingue

Séries d'images cohérentes comptant jusqu'à 10 images

Jusqu'à 10 images de référence et éléments personnalisés

Visuels longs pour l'e-commerce et les pages web

Architecture unifiée et prise en charge des prompts détaillés
Paramètres d'API kling-4-0/image sur Kie.ai
Paramètres pour POST /api/v1/jobs/createTask lorsque model est défini sur kling-4-0/image.
| Parameter | Valeurs et règles |
|---|---|
| model | kling-4-0/image |
| prompt | Obligatoire ; jusqu'à 20 000 caractères dans l'API et le playground (mettez le texte de l'image entre guillemets ; citez @image_1… et @name) |
| image_urls | Facultatif ; jusqu'à 10 URL d'images (JPG, JPEG ou PNG ; max. 20 Mo chacune ; format d'image entre 2:5 et 5:2 ; côté le plus long jusqu'à 8 192 px) |
| elements | Sujets personnalisés facultatifs ({name, image_urls[2..4], tag, description}) ; image_urls + elements ≤ 10 |
| mode | default (par défaut) ou series (série d'images cohérente) |
| count | 1 à 9 en mode default (1 par défaut) ; 2 à 10 obligatoire en mode series |
| resolution | 2k (par défaut), 4k ou 8k (2k/4k renvoient généralement du PNG ; 8k renvoie du JPEG) |
| aspect_ratio | auto (par défaut), 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
Paramètres de l’API kling-4-0/long-image sur Kie.ai
Paramètres pour POST /api/v1/jobs/createTask lorsque model est défini sur kling-4-0/long-image (génère 1 image longue par tâche ; ne mélangez pas les champs entre les skills).
| Parameter | Valeurs et règles |
|---|---|
| model | kling-4-0/long-image |
| skill | Obligatoire : ecommerce (page de détail produit) ou webpage (conception de page web) |
| prompt | Obligatoire ; jusqu'à 20 000 caractères (citez @image_1… dans ecommerce ; @style et @subject dans webpage) |
| image_urls | Obligatoire pour ecommerce uniquement : 1 à 3 URL d'images de produit (JPG, JPEG ou PNG ; max. 20 Mo chacune ; le format d'image doit être compris entre 2:5 et 5:2, sinon la tâche échoue) |
| length | E-commerce uniquement : court (environ 2–5 sections), moyen (environ 6–10 sections, par défaut) ou long (environ 11–18 sections) dans une seule image longue |
| style_image, subject_image | Page web uniquement : URL JPG, JPEG ou PNG facultatives (20 Mo maximum chacune), référencées par @style et @subject |
| resolution | 1k ou 2k (2k par défaut) |
Comment utiliser la Kling Image 4.0 API sur Kie.ai
- 1
Étape 1 : testez dans l’espace de test ou choisissez un point de terminaison
Essayez des consignes dans l’espace de test de cette page. Utilisez kling-4-0/image pour les images fixes en 2K, 4K et 8K, les retouches à partir de références et les séries de 2 à 10 images, ou kling-4-0/long-image pour les pages détaillées de produits e-commerce et les maquettes de pages web générées sous forme d’une seule image. - 2
Étape 2 : structurez les consignes, les références et les citations
Placez tout texte à afficher entre guillemets. Référencez les image_urls dans l’ordre avec @image_1, @image_2 et les elements de sujets personnalisés avec @name dans kling-4-0/image, ou utilisez @style et @subject pour les tâches d’images longues de pages web. - 3
Étape 3 : créez une tâche de génération
Envoyez une requête POST à https://api.kie.ai/api/v1/jobs/createTask avec un en-tête Authorization: Bearer YOUR_API_KEY. Définissez model sur le point de terminaison choisi, ajoutez éventuellement callBackUrl, puis incluez la consigne obligatoire dans prompt et les paramètres pris en charge sous input : utilisez aspect_ratio et mode avec kling-4-0/image, et incluez le champ obligatoire skill pour kling-4-0/long-image. - 4
Étape 4 : récupérez les URL des images générées
Recevez les webhooks de fin de tâche à l’adresse callBackUrl ou interrogez régulièrement GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=... pour lire resultUrls. Avec kling-4-0/image, les images en 2K et 4K sont généralement au format PNG, tandis que les images en 8K sont au format JPEG.