Kling Image 4.0 Long Imageチュートリアル
Kling Image 4.0 Long Imageで2KのWebページとEC商品詳細ページを制作。2件の実測例、curl例、ポーリング手順、料金を解説します。
Markdown で読む通常の画像生成モデルは1枚ずつ独立したフレームを出力します。そのため商品詳細ページや製品発表サイト全体を作ろうとすると、ばらばらなバナーを6枚ほど生成し、レイアウトツール上で余白のズレやフォントの不統一、商品サイズのばらつきを手作業で整える羽目になります。Kling Image 4.0 Long Imageは仕組みが根本的に異なります。1回のAPIリクエストで上から下まで構造化された連続縦長PNGを1枚出力し、横幅は1K(1024 px)または2K(2048 px)に固定されたまま、高さは構成案のセクション量に応じて自動で伸縮します。
2026年11月19日、実務を想定した構成案で両モードを検証するため、SeedRouterの /v1/images/generations エンドポイント経由で2Kの生成ジョブを2件実行しました。1件目はテキストのみの webpage モードで、架空のスタジオヘッドホンブランド向け発表ページ(2048 × 16385 px、17 MB、169秒)を生成しました。2件目は既存のジュエリー参照写真を2枚渡した ecommerce モード(medium)で、商品詳細ページ(2048 × 19533 px、25 MB、261秒)を生成しました。以下で両方の全体展開を確認できるほか、Kling Image 4.0 Long Imageプレイグラウンドでどちらの構成案もそのまま試せます。最新のティア別料金は記事後半のリアルタイム表でご確認ください。
書き始める前に ecommerce か webpage かを決める
settings.skill は必須パラメーターであり、レイアウトの設計文法だけでなくAPIが受け付ける項目そのものを切り替えます。見た目のプリセットではなく、2つの別契約として扱うのが確実です。
実際の商品写真がすでに手元にあり、自社ECやモール向けの縦長商品詳細ページ(PDP)を作りたいときは ecommerce を選びます。ecommerce モードでは contents 内に1〜3件の refer_image を含める必要があり、縦方向のボリュームは settings.length(short、medium、long。デフォルトは medium)で指定します。商品参照画像が0枚のリクエストは課金前のバリデーションで拒否されます。
ブランドのランディングページ、新製品発表サイト、エディトリアル調のWebレイアウトを設計するときは webpage を選びます。webpage モードでは参照画像が任意となり、テキストのみで生成できるほか、配色やレイアウトのリズムを伝える style_refer_image と、主役となる被写体を固定する subject_refer_image をそれぞれ最大1枚まで指定できます。なお、webpage モードで refer_image や settings.length を送ってはいけません。どちらも ecommerce 専用パラメーターのため、混在させるとバリデーションエラーになります。
| 設定・入力項目 | ecommerce モード | webpage モード |
|---|---|---|
settings.skill | "ecommerce"(必須) | "webpage"(必須) |
settings.length | "short"、"medium"(デフォルト)、"long" | 指定しない |
settings.resolution | "1k"(幅 1024 px)または "2k"(幅 2048 px) | "1k"(幅 1024 px)または "2k"(幅 2048 px) |
refer_image 項目 | 必須:公開JPEG/PNGのURL 1〜3件 | 指定不可 |
style_refer_image / subject_refer_image | 指定不可 | 任意:各最大1件 |
どちらのモードでも 4k、バッチ枚数(n)、アスペクト比は指定できません。成功したタスクは必ず output.data[0].url に縦長PNGのURLを1件だけ返します。
実測1:テキストのみで生成した2K Webページレイアウト(2048 × 16385)

上図は webpage 2Kモードで生成した縦長ページを4等分して横に並べた全体図です。構成案では、開放型平面駆動ヘッドホン「S-01 Reference Planar」向けのダークオブシディアン基調・スイスインダストリアル調発表ページを指定しました。ミニマルなトップバー、斜め前方のヒーロー写真、3カラムの音響ハイライト、CNC切削加工のカットアウェイ図、実在する電気仕様を並べたスペック表、落ち着いたフッターという構成です。
1回の連続描画でどこまで崩れずに仕上がったか詳しく見てみます。縦 16,385 ピクセルにわたり、ダークチャコールの背景、セリフ体のディスプレイ見出し、ヘアライン加工アルミの筐体形状が、上部ナビゲーションから下部の5色バリエーション帯・仕様表まで一貫していました。指定した電気スペックの数値もすべて判読できる精度で描画されています(106 mm Iso-Planar、32 Ohms、98 dB/mW、8 Hz–52 kHz、410 g)。一方、完成PNGを等倍(100%)で検品すると気づく点もありました。プロンプトでは仕様表の背面に明るいアラバスター帯を指定しましたが、実際には仕様表がダークスレートのまま維持され、その下のニュースレター登録セクションに明るいグレー帯が置かれていました。実装ハンドオフで特定セクションの背景色切り替えが厳密に必要な場合は、出力画像をビジュアルディレクションの基準として使い、切り出した写真素材をもとに該当帯だけHTMLで組み直す運用が安全です。
webpage モードで狙い通りの結果を得るには、静止画用プロンプトよりもワイヤーフレーム仕様書に近い書き方をします。冒頭に全体のデザイントークン(背景HEX、素材感、アクセントカラー、グリッド方針)をまとめ、続いて上から下へ番号付きで各セクションを定義し、見出しや主要数値は具体的な英語コピーで明記します。見出しを曖昧なまま残すとダミー文言が入りやすくなります。
curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.jsonこのペイロードでは settings.length を省略し、contents に prompt 項目だけを渡している点に注目してください。全パラメーターの仕様はKling Image 4.0 Long Image APIリファレンスで確認できます。[1]
実測2:参照画像2枚で生成した2K EC商品詳細ページ(2048 × 19533)

2件目の検証では、settings.skill を "ecommerce"、settings.length を "medium"、resolution は "2k" のままにし、既存のジュエリー写真2枚を refer_image として渡しました。1枚目は蘭モチーフのゴールドドロップイヤリングのマクロ写真(id: "earring")、2枚目は同じイヤリングを着けた女性の温室ポートレート(id: "model")です。
プロンプト内の各セクション記述では、この2枚の素材を @earring と @model で呼び出しています。API側で名前付きIDが自動的に位置参照へ変換されるため、配列インデックスを手動で数える必要はありません。参照写真はすべて 30 MB 以下の公開JPEG/PNG URLで、縦横各 300 px 以上、アスペクト比 2:5 〜 5:2 を満たす必要があります。

この1回の medium・2K呼び出しで生成された縦 19,533 ピクセルのPNGには、EC向けの6つのモジュールが一通り収まっていました。シャンパンシルク背景のヒーロー、情緒的なデザインストーリー帯、白抜きスタジオ写真と6行の製品仕様表(Phalaenopsis No. 4 Drop Earring、18K Recycled Yellow Gold、48 mm drop length、Forest-green velvet presentation box)、@model に忠実な On The Ear 着用ポートレート、6角度の商品グリッド(Front、Side、Back、Core Detail、Hook Detail、Profile)、そして上に拡大掲載した注釈付き Craft And Beauty ディテール図です。
ただしフル解像度での検品により、本番カタログへそのまま載せる前に押さえておくべき課題も1点見つかりました。仕様表の製品名 Phalaenopsis No. 4 Drop Earring や各注釈ラベルの綴りは正確だったものの、最上部のヒーローバナーでは指定したブランド名 L'ORCHIDÉE ではなく、Botanical Series が短縮された BOTA SERIES や BOTA — Drop Earring として描画されていました。長尺ページの文字描画では、本文の短いラベルや仕様行が安定している一方で、装飾的な大文字ヒーローロゴが崩れるケースが典型的に起きます。公開前には必ずヒーロー見出しを等倍で確認し、法的に厳密なブランドロゴや表記義務のある注記はストアテンプレート側のベクター要素として重ねるのが確実です。
curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.jsonwebpage モードで参照画像を使う場合もルールは明確です。ビジュアルの方向性には style_refer_image、主役の商品には subject_refer_image を指定し、それぞれ1〜32文字の半角英数字(スペース不可)で一意の id を付けてプロンプトから @id で参照します。同じ contents 配列内で id を重複させないでください。
焦らずポーリングし、大容量2K PNGのダウンロードに備える
縦長レイアウトは通常の1枚生成よりも処理時間が長く、返却ファイルもはるかに重くなります。数秒で返るサムネイル生成APIと同じ感覚で扱うと、クライアントタイムアウトや意図しない二重課金の原因になります。
11月19日の実測では、2048 × 16385 のWebページが 169秒(17 MB)、2048 × 19533 のmedium EC詳細ページが 261秒(25 MB)で完了しました。long 指定の2K ECページでは7分を超え、サイズも 50 MB を上回る場合があります。POST /v1/images/generations が返ったらすぐにタスクIDを永続化し、GET /v1/tasks/{id} を15〜20秒間隔でポーリングしてください。端末接続が切れたりクライアントがタイムアウトしたりしても、同じ内容で2回目の POST を再送してはいけません。[2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.jsonstatus が completed になったら、output.data[0].url から単一PNGのURLを取り出し、余裕のあるタイムアウトを指定してディスクへ直接保存します。
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.pngバックエンドのワーカー処理では、PNG全体を小さな固定メモリバッファへ読み込んでから書き出す実装は避けてください。HTTPレスポンスボディをそのままファイルやオブジェクトストレージへストリーミング保存し、モバイルEC向けにスライスする前に画像寸法を確認したうえで、表示用プレビューはWebPへ変換し、印刷や再スライス用の原本としてPNGを保管するのが実用的です。
全8出力ティアと参照画像の予算設計
Kling Image 4.0 Long Imageの料金は、skill(ecommerce か webpage)、length(ecommerce モード時の short / medium / long)、resolution(1k か 2k)の3要素で決まります。さらにすべての入力参照画像(refer_image、style_refer_image、subject_refer_image)に対して、無料枠なしで1枚目から入力画像料金が加算されます。
そのため下書きと清書の使い分けはシンプルです。ECカタログ向けにセクション順や見出しのリズム、配色の強弱を詰める段階では、まず 1k の short または medium で流れを検証し、構成が固まってから 2k で本番出力します。一方 webpage モードでは 1k と 2k の単価差が小さいため、細かい仕様表の文字まで鮮明に見せたい段階に入ったら早めに 2k を選ぶ方が手戻りが少なくなります。今回の実測1件目は webpage 2Kの料金ちょうどで精算され、2件目は ecommerce medium 2Kの料金に参照画像2枚分の料金が加算されました。失敗したリクエストには課金されません。現在の単価は以下の表で確認できるほか、Kling Image 4.0 Long Image料金計算ツールで正確な構成を試算できます。[3]
Kling Image 4.0 Long Imageの料金
| カテゴリ | 料金 (USD) |
|---|---|
| Ecommerce · 1K · short | $0.2269 |
| Ecommerce · 2K · short | $0.2723 |
| Ecommerce · 1K · medium | $0.4538 |
| Ecommerce · 2K · medium | $0.5294 |
| Ecommerce · 1K · long | $0.7563 |
| Ecommerce · 2K · long | $0.8319 |
| Webpage · 1K | $0.5294 |
| Webpage · 2K | $0.5748 |
| 参照画像 | $0.003025 |
よくある質問
ecommerce モードで short、medium、long はどう使い分けますか?
まず商品紹介に必要なモジュール数を数えてから length を決めてください。short はヒーロー、主要メリット、簡易仕様など3〜4帯に絞った構成に向いています。medium は上記のジュエリー実測例のように6セクション前後(ヒーロー、ストーリー、白抜き+仕様表、着用写真、多角度グリッド、注釈図)を余裕を持って収められます。long は比較表、手順パネル、同梱物一覧まで文字を詰め込まずに展開したいハードウェア製品や複数SKUの商品ページに取っておくのが適切です。
webpage リクエストでHTTP 400が返る原因は何ですか?
最も多いバリデーションミスは、skill: "webpage" と同時に settings.length を送ってしまうケースと、参照画像に style_refer_image や subject_refer_image ではなく type: "refer_image" を指定してしまうケースです。どちらも ecommerce 専用項目です。あわせて、プロンプト文字数が加重上限(@id 置換後の判定で en / 166000 + non_en / 71000 <= 1)に収まっているか、および resolution が "1k" または "2k" になっているかも確認してください。
本番のECサイトでは完成PNGをスライスすべきですか?
はい。2048 × 19533 の非圧縮PNGは 17 〜 25 MB にもなり、モバイル回線で単一の <img> タグとして配信するには重すぎます。セクション境界に沿って横方向にスライスし、各帯をWebPまたはAVIFに圧縮して段階的に読み込ませたうえで、重要な商標表記・価格・購入ボタンは通常のHTMLテキストに置き換えてください。パイプラインへ組み込む前に、Kling Image 4.0 Long Imageプレイグラウンドでプロンプトと縦長出力全体を直接確認できます。



