Image
Kling Image 4.0 Long Image
Kling Image 4.0 Long Imageで1Kまたは2KのEC商品詳細ページや縦長Webページデザインを生成し、ポーリングで完成したPNGのURLを取得します。
POST /v1/images/generations に、モデルID kling-image-4-0-long-image を指定したJSONリクエストを送信します。返されたタスクIDを保存し、縦長PNG 1枚の生成が完了するまで GET /v1/tasks/{id} をポーリングしてください。
簡単な例
このリクエストでは、テキストの構成案から1KのWebページレイアウトを1枚生成します。APIキーは環境変数 SEEDROUTER_API_KEY に保存してください。
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'エンドポイントとヘッダー
POST https://api.seedrouter.ai/v1/images/generations に、Content-Type: application/json と Authorization: Bearer YOUR_API_KEY を付けてJSONを送信します。APIキーは必ずサーバー側で管理してください。
パラメーター
| フィールド | 型 | 値とデフォルト |
|---|---|---|
model | string, 必須 | kling-image-4-0-long-image |
contents | array, 必須 | prompt 項目1件と、モードに応じた参照画像項目を指定します。 |
contents[].type | string, 必須 | prompt、refer_image(ecommerce 専用・1〜3件必須)、style_refer_image(webpage 専用・最大1件)、または subject_refer_image(webpage 専用・最大1件)。element は非対応です。 |
contents[].text | string | prompt で必須。英語のみの上限は166,000文字、非英語文字の上限は71,000文字です。混在時は english / 166000 + non_english / 71000 <= 1 を満たす必要があります。 |
contents[].url | string | 各画像項目で必須。30 MB以下の公開HTTP(S) URL(JPEGまたはPNG)、各辺300 px以上、アスペクト比2:5〜5:2。 |
contents[].id | string | 任意。リクエスト内の全画像項目で一意の参照IDを指定します。プロンプト内では @id として参照できます。 |
settings.skill | string, 必須 | 商品詳細ページには ecommerce、Webページデザインには webpage を指定します。 |
settings.length | string | short(約2〜5セクション)、medium(デフォルト、約6〜10セクション)、long(約11〜18セクション)。ecommerce のみ有効で、webpage では無視されます。 |
settings.resolution | string | 1k(デフォルト、幅1024 px)または 2k(幅2048 px)。高さは内容に応じて変動します。4k は非対応です。 |
options.watermark_info.enabled | boolean | 任意。false のみ対応しています。 |
EC商品詳細ページ
ecommerce モードでは1〜3件の refer_image が必須です。プロンプト内でそれぞれの写真の id を参照してください。
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}スタイル・被写体参照を使ったWebページデザイン
webpage モードでは任意の style_refer_image(最大1件)と subject_refer_image(最大1件)を指定できます。webpage モードでは settings.length を省略してください。
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}縦長画像を取得する
POSTレスポンスの id を TASK_ID にコピーし、ステータスが completed または failed になるまでポーリングします。縦長画像タスクは通常数分かかり、特に long と 2k を組み合わせたレイアウトでは所要時間が長くなります。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"完了したら output.data[0].url を読み取ります。1リクエストにつき完全な縦長PNGが1枚生成されます。2k の長尺ページは50 MBを超えることがあるため、ダウンロードのタイムアウトとビューアの表示倍率に余裕を持たせてください。詳しくはタスクリファレンスおよびエラー一覧をご確認ください。
料金
完了したリクエストごとに、出力ティア料金1件(ecommerce は resolution × length、webpage は resolution で決定)に加え、入力画像1枚ごとの参照画像料金(1枚目から対象)が課金されます。失敗したリクエストには課金されません。最新の料金表をご参照ください。
エラーと運用のヒント
不正なリクエストは課金前にHTTP 400を返します。よくあるバリデーションエラーは、settings.skill の未指定、ecommerce で1〜3件の refer_image URLを省略、webpage モードでの refer_image 混在、4k の指定、参照IDの重複です。
プロンプトにはヒーローバナーから仕様表やフッターまで正確なセクション順を明記し、レイアウトの正確さを保つため確認済みの製品情報だけを記載してください。Kling Image 4.0 Long ImageプレイグラウンドやOpenAPIスキーマもあわせてご活用ください。
