
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:ネイティブ8K画像、タイポグラフィ、統一感のある画像セット

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"}}'
Kling Image 4.0の主な機能


最大2,000文字の多言語テキスト描画

最大10枚の統一感ある画像セット

最大10件の参照画像とカスタムelements

縦長のEC商品ページ・Webページビジュアル

統合アーキテクチャと詳細なプロンプトへの対応
Kie.aiにおけるkling-4-0/imageのAPIパラメータ
modelをkling-4-0/imageに設定した場合のPOST /api/v1/jobs/createTaskのパラメータです。
| Parameter | 値とルール |
|---|---|
| model | kling-4-0/image |
| prompt | 必須。APIおよびプレイグラウンドで最大20,000文字(画像内テキストは引用符で囲み、@image_1…および@nameで参照) |
| image_urls | 任意。最大10件の画像URL(JPG、JPEG、またはPNG、各最大20MB、アスペクト比2:5〜5:2、長辺最大8,192px) |
| elements | 任意のカスタム被写体({name, image_urls[2..4], tag, description})。image_urls + elements ≤ 10 |
| mode | default(デフォルト)またはseries(一貫性のある画像セット) |
| count | defaultモードでは1〜9(デフォルトは1)。seriesモードでは2〜10が必須 |
| resolution | 2k(デフォルト)、4k、または8k(2k/4kは通常PNG、8kはJPEGを返します) |
| aspect_ratio | auto(デフォルト)、1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9 |
Kie.aiのkling-4-0/long-image APIパラメータ
modelをkling-4-0/long-imageに設定した場合のPOST /api/v1/jobs/createTaskのパラメータです(1タスクにつき縦長画像を1枚出力。異なるskill間でフィールドを混在させないでください)。
| Parameter | 値とルール |
|---|---|
| model | kling-4-0/long-image |
| skill | 必須:ecommerce(商品詳細ページ)またはwebpage(Webページデザイン) |
| prompt | 必須。最大20,000文字(ecommerceでは@image_1…、webpageでは@styleおよび@subjectで参照) |
| image_urls | ecommerceのみ必須:1〜3件の商品画像URL(JPG、JPEG、またはPNG、各最大20MB、アスペクト比は2:5〜5:2である必要があり、範囲外の場合はタスクが失敗します) |
| length | ecommerceのみ:1枚の縦長画像内にshort(約2〜5セクション)、medium(約6〜10セクション、デフォルト)、またはlong(約11〜18セクション) |
| style_image, subject_image | webpageのみ:任意のJPG、JPEG、またはPNGのURL(各最大20MB)。@styleおよび@subjectとして参照 |
| resolution | 1kまたは2k(デフォルトは2k) |
Kie.aiでKling Image 4.0 APIを使用する方法
- 1
ステップ1:プレイグラウンドでテストするかエンドポイントを選択する
このページのプレイグラウンドでプロンプトを試せます。2K、4K、8Kの静止画、参照画像による編集、2〜10枚の画像セットにはkling-4-0/imageを使用し、単一出力のEC商品詳細ページやWebページのデザインにはkling-4-0/long-imageを使用します。 - 2
ステップ2:プロンプト、参照情報、引用符で囲むテキストを整理する
描画したいテキストは引用符で囲みます。kling-4-0/imageではimage_urlsを順番に@image_1、@image_2として、カスタムの被写体elementsを@nameとして参照します。Webページの縦長画像タスクでは@styleおよび@subjectを使用します。 - 3
ステップ3:生成タスクを作成する
Authorization: Bearer YOUR_API_KEYヘッダーを付与して、https://api.kie.ai/api/v1/jobs/createTaskにPOSTリクエストを送信します。modelに選択したエンドポイントを設定し、任意でcallBackUrlを追加します。inputの下に必須のプロンプトと対応する設定を含めます(kling-4-0/imageではaspect_ratioとmodeを使用し、kling-4-0/long-imageでは必須のskillフィールドを含めます)。 - 4
ステップ4:生成された画像のURLを取得する
callBackUrlで完了のWebhookを受信するか、GET https://api.kie.ai/api/v1/jobs/recordInfo?taskId=...をポーリングしてresultUrlsを読み取ります。kling-4-0/imageの場合、2Kおよび4Kの出力には通常PNGが使用され、8Kの出力にはJPEGが使用されます。