· reAPI Team
Kling Image 4.0 Long Image チュートリアル
reAPIでKling Image 4.0 Long Imageを使い、EC商品詳細ページやWebページレイアウトを作成する方法を、モード仕様、参照ID、料金、確認手順とともに解説します。

一般的な画像生成モデルは、正方形や16:9のフレームを1枚ずつしか出力しません。ECサイトの商品詳細ページ全体や、途切れのない縦長ランディングページが必要なときに、6枚の静止画を手作業でつなぎ合わせると、継ぎ目ごとにライティング、余白、タイポグラフィの統一感がほとんど確実に崩れてしまいます。Kling Image 4.0 Long Image は、1回のリクエストで最上部のヒーローからフッターまで連続した1枚の縦長PNGを生成することで、この課題を解決します。[1]
本チュートリアルでは、reAPIにおける webpage モードと ecommerce モードそれぞれの正確な仕様について、参照画像のルール、@id 指定、1Kと2Kの解像度計画、2026年11月20日時点の最新のreAPIページ単位料金、そして縦長PNGファイルに求められるポーリングとファイル検査の手順まで詳しく解説します。[2]
クイックサマリー
- 2種類のスキル: すべての呼び出しで
settings.skillが必須です。フルスクロールのランディングページ案にはwebpage(任意の参照画像0〜2枚、settings.lengthは指定しない)、商品詳細ページにはecommerce(refer_image写真1〜3枚が必須、長さはshort、medium、longから選択)を選びます。[1] - 1タスクにつき縦長PNG 1枚: 出力幅は1K(1024 px)または2K(2048 px)に固定され、縦方向の高さは構成案のセクション数に応じて調整されます。
4kには対応していません。[2] - 参照の役割は混在不可:
refer_imageはecommerceモードでのみ機能し、style_refer_imageとsubject_refer_imageはwebpageモードでのみ機能します。要素参照(element references)には対応していません。[2] - ページ単位の従量課金: 2026年11月20日時点の確認では、reAPIの料金は $0.2269(
ecommerce、short、1k)から $0.8319(ecommerce、long、2k)の範囲で、webpageは $0.5294(1k)または $0.5748(2k)、さらに1枚目から入力参照画像1枚につき $0.003025 が加算されます。詳しくはライブ料金表をご覧ください。[3] - 長時間の生成と大容量ファイルへの備え: 複数セクションの生成は通常数分かかり、2Kの縦長PNGは50 MBを超えることがあります。HTTPダウンロードのタイムアウトと画像ビューアをそれに合わせて設定してください。[2]
まず1Kのwebpage構成案から始める
複数の商品写真をアップロードしたり、2Kのロングレイアウトに課金したりする前に、まずはテキストのみの webpage リクエストを1K幅でKling Image 4.0 Long Imageに1回送信しましょう。1Kのwebpageジョブを使えば、高解像度ピクセルの生成や参照画像の設定に余計な時間をかけずに、縦方向セクションのテンポ、色のコントラスト、視覚的階層を確認できます。
1つの prompt 項目内に、すべてのセクションを上から下への正確な順番で列挙してください。ヒーローバナー、中間の機能帯、グリッドや比較帯、そして末尾のフッターブロックを明記します。「おしゃれなコーヒーサイトを作って」といった曖昧な指示ではセクション数やビジュアルのリズムが運任せになりますが、番号付きの縦方向アウトラインを書いておけば、出力を検品する際の具体的なチェックリストになります。
curl https://reapi.ai/api/v1/images/generations \
-H 'Authorization: Bearer YOUR_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. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
}
],
"settings": {
"skill": "webpage",
"resolution": "1k"
}
}'このエンドポイントは、タスクの id と status: "processing" を含むJSONオブジェクトを返します。そのIDをすぐに保存してください。10秒ほどで終わる単体静止画エンドポイントとは異なり、連続した複数セクションのレイアウト生成にはより長い時間がかかります。同じBearerキーを使って status が completed または failed に変わるまで GET /api/v1/tasks/{id} をポーリングしてください。[4]
Kling Image 4.0 Long Imageでecommerceモードかwebpageモードを選ぶ
Kling Image 4.0 Long Imageへのすべてのリクエストでは settings.skill が必須です。スキルごとに許可される参照タイプや長さの制御が厳密に定められており、これらを混在させると課金前にバリデーションエラーとなるため、適切なモードを選ぶことが重要です。[2]
| ルール | ecommerce モード | webpage モード |
|---|---|---|
| 対象出力 | 複数セクションの商品詳細ページ | フルスクロールのWebページビジュアルレイアウト |
| 許可される参照タイプ | refer_image のみ | style_refer_image および subject_refer_image のみ |
| 参照画像枚数 | 1〜3枚が必須 | スタイル0〜1枚、被写体0〜1枚(いずれも任意) |
settings.length | short、medium(デフォルト)、または long | 無視される(リクエストから省略) |
settings.resolution | 1k(デフォルト)または 2k | 1k(デフォルト)または 2k |
options.watermark_info.enabled | false のみ | false のみ |
すでに実際の商品写真が手元にあり、オンラインストア向けの一貫性ある縦長商品紹介シートが必要な場合は、Kling Image 4.0 Long Imageの ecommerce モードを使用してください。3つの長さティアは開発元が案内するおおよそのセクション数に対応しており、short は約2〜5セクション、medium は約6〜10セクション、long は約11〜18セクションを目安としています。[1]
ブランドのランディングページ、ローンチページ、エディトリアルなマイクロサイトを試作しており、純粋なコピーから始めたり、1枚のビジュアルスタイル参照と1枚のヒーロー被写体写真を組み合わせたりしたい場合は、Kling Image 4.0 Long Imageの webpage モードを使用します。webpage モードでは length の列挙値ではなくセクションの記述リストから縦方向の長さを見積もるため、settings.length を省略しておくとリクエストをクリーンかつスキーマどおりに保てます。
バリデーションエラーを起こさずに名前付き参照を設定する
参照画像は、Kling Image 4.0 Long Imageの縦長スクロール全体で実在の商品を正しく認識させ続けるための主要な手段です。contents 内の各参照アイテムには type、公開アクセス可能なHTTPまたはHTTPSの url、および任意の一意の id を指定します。Base64文字列や data: URIはreAPIゲートウェイで拒否されます。[2]
送信前に、すべての参照ファイルが次の4つの形式チェックを満たしている必要があります。
- 形式: JPEGまたはPNGのみ。
- ファイルサイズ: 画像1枚あたり最大30 MB。
- 最小解像度: 幅・高さともに300ピクセル以上。
- アスペクト比: 2:5から5:2の間。
エンドポイントを呼び出す前に、ログアウト状態のブラウザウィンドウで各参照リンクを確認してください。有効期限付きのダッシュボードCookieの背後にあるアセットURLは、レンダリングワーカーが取得する際に失敗します。
ecommerce商品詳細ページの例
Kling Image 4.0 Long Imageの ecommerce モードでは、refer_image エントリを1〜3件指定し、それぞれの角度に front や spout のような分かりやすい短い id を付けます。プロンプト内でそれらの名前を @front や @spout として直接引用することで、どの写真がヒーローバナーを固定し、どの写真がクローズアップ解説帯に使われるかをレイアウト側へ正確に伝えられます。
{
"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 a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}webpageスタイル参照・被写体参照の例
Kling Image 4.0 Long Imageの webpage モードでは、デザインの方向性と商品本体を切り分けます。カラーパレット、グリッドのリズム、タイポグラフィの雰囲気を導くために最大1枚の style_refer_image を添付し、実物オブジェクトの形状を正確に保つために最大1枚の subject_refer_image を添付します。リクエスト内のすべての id は一意でなければなりません。
{
"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 tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}長い構成案を書く際は、重み付きプロンプト上限にご注意ください。Kling Image 4.0 Long Imageは英語文字で最大166,000文字、非英語文字で最大71,000文字まで受け付け、混在テキストでは english / 166000 + non_english / 71000 <= 1 の制約がかかります。この上限は @id 名が位置マーカーへ変換された後に再度検証されるため、プロンプトが上限に近い場合は少し余裕を持たせてください。[2]
1K・2K・ページ長ティア別の予算を立てる
出力タイルごとに課金される一般的な静止画生成モデルとは異なり、Kling Image 4.0 Long Imageでは完了したリクエストごとに「出力ティア料金1回分+入力参照画像1枚ごとの料金(1枚目を含む)」が請求されます。出力が配信されずに失敗した生成では、予約されていたクレジットが自動的に解放されます。[2]
以下の表は、2026年11月20日時点に確認されたreAPIの現行料金(1 credit = $0.001 USD、$1 = 1,000 credits)です。大量のバッチを実行する前には、必ず Kling Image 4.0 Long Image料金ページ で有効な最新単価をご確認ください。[3]
| ティア | 解像度 | reAPI料金(2026年11月20日確認) | 主な用途 |
|---|---|---|---|
ecommerce · short | 1k / 2k | $0.2269 / $0.2723 | コンパクトな2〜5セクションの商品サマリー |
ecommerce · medium | 1k / 2k | $0.4538 / $0.5294 | 標準的な6〜10セクションのストアフロント詳細ページ |
ecommerce · long | 1k / 2k | $0.7563 / $0.8319 | フル構成の11〜18セクション主力商品シート |
webpage | 1k / 2k | $0.5294 / $0.5748 | フルスクロールのランディングページ・キャンペーン構成 |
| 入力参照画像 | すべて | 1枚あたり $0.003025 | 指定した参照写真ごとに1回課金 |
2026年11月20日時点の単価を使った具体的な計算例として、商品写真2枚付きの ecommerce medium 2k リクエストは合計 $0.5294 + 2 × $0.003025 = $0.53545 となります。送信時にreAPIは整数クレジットで ceil(0.53545 × 1000) = 536 クレジットを仮予約し、完了時に正確なマイクロドル単位で精算して端数差額を残高へ返還します。[2]
Kling Image 4.0 Long Imageのコストを抑える実践的な方法が、2段階ワークフローです。まず 1k(商品の再現度を先に検証したい場合は ecommerce short 1k)でレイアウト順とセクション構成案の下書きを作成し、すべての帯を確認してビジュアルの流れが固まってから 2k へ引き上げます。
確実なポーリングと縦長PNG出力の検品
Kling Image 4.0 Long Imageのリクエストを送信したら、5〜10秒ごとなど一定間隔で GET /api/v1/tasks/{id} をポーリングしてください。long かつ 2k のジョブではクライアント側のタイムアウト予算を少なくとも15〜20分確保します。ポーリングリクエストが一時的に失敗しても POST /v1/images/generations を自動再試行しないでください。新規POSTのたびに別の課金対象タスクが作成されてしまいます。[4]
status が completed になったら、output.image_urls[0] から単一のURLを読み取り、すぐに自身のストレージへPNGをコピーしてください。2Kの縦長レイアウトは50 MBを超え、縦15,000ピクセル以上に達することもあるため、小容量のサーバーレス関数メモリ上にファイル全体をバッファリングせずディスクへストリーミングダウンロードし、結果を次の2段階で検品します。
- 全高サムネイルスキャン: 縮小表示で縦方向のリズム、上から下までの色調の一貫性、セクション間の明確な区切りを確認します。
- 100%拡大でのセクション別クロップ確認: ヒーロー見出し、商品のシルエット、素材の質感、特徴キャプション、最下部の仕様ブロックを等倍ピクセルで確認します。
構成案には確認済みの商品寸法、保証条件、技術仕様のみを記載してください。100%拡大でコピーの正確さを点検しておくことで、ストアフロントのスライス作業やフロントエンド実装に進む前に、数値の歪みや文字欠けを発見できます。
よくある質問
Kling Image 4.0 Long Imageで4Kの縦長ページを生成できますか?
いいえ。Kling Image 4.0 Long Imageが対応している出力は 1k(幅1024 px)と 2k(幅2048 px)のみです。4k を指定したリクエストはクレジットが予約される前にバリデーションエラーで拒否されます。4Kの個別静止画や複数ショットのセットが必要な場合は、Kling Image 4.0 をご利用ください。
参照画像0枚でecommerceリクエストを送るとバリデーションに失敗するのはなぜですか?
ecommerceモードでは、モデルがすべての縦方向セクションを実際の商品写真に基づいて構成できるよう、contents 内に1〜3件の refer_image 項目が必須となっているためです。テキストのみで縦長レイアウトを生成したい場合は、settings.skill を webpage に設定してください。
1回のリクエストでrefer_imageとstyle_refer_imageを併用できますか?
いいえ。参照の役割はモードごとに厳密に分かれています。ecommerce が受け付けるのは refer_image のみであり、webpage が受け付けるのは style_refer_image と subject_refer_image のみです。プレイグラウンドでは送信前にブロックされ、API から直接送信した場合はクレジットが一時確保された後に非同期処理で失敗し、確保分は自動返還されます。
1枚目の参照画像も課金対象になりますか?
はい。contents に指定されたすべての入力参照画像は、1枚目から完了タスクごとに1回ずつ課金されます。出力なしで失敗したタスクでは、予約されていたクレジットが自動的に解放されます。
Kling Image 4.0 Long ImageとKling Image 4.0の違いは何ですか?
Kling Image 4.0 Long Imageは、縦長のEC商品詳細ページやWebページレイアウト向けに特化した連続した1枚の縦長PNGを出力します。一方、Kling Image 4.0 は標準アスペクト比の静止画(独立した候補最大9枚または2〜10ショットのシリーズ)を2Kまたは4Kで出力します。
50 MBを超える縦長PNG出力のダウンロードはどう処理すべきですか?
HTTPダウンロードのタイムアウトを60秒以上に設定し、レスポンスのバイトストリームを直接オブジェクトストレージまたはディスクへ書き出してください。また、画像スライススクリプトを実行する前に、ダウンロード後の Content-Length またはPNGの解像度サイズを検証してください。
Kling Image 4.0 Long Imageを本番ワークフローに組み込む
まずは Kling Image 4.0 Long Image プレイグラウンド で 1k の webpage プロンプトを1件試し、セクションのテンポと視覚的バランスを確認することから始めましょう。縦方向のアウトラインがストアフロントやキャンペーンの構成と一致したら、参照URLを固定し、Kling Image 4.0 Long Image APIドキュメント のスキーマに従って、output.image_urls[0] を起点とした再現可能なポーリング・スライス用パイプラインを構築してください。
参考資料
- Kling AI, Kling Image 4.0 Long Image Generation API — 公式の
ecommerceおよびwebpageスキル仕様、長さティアの目安、参照枚数上限。 - reAPI, Kling Image 4.0 Long Image API documentation — リクエストスキーマ、HTTP(S)参照制約、重み付きプロンプト上限、出力スキーマ、課金仕様。
- reAPI, Kling Image 4.0 Long Image model page and live pricing — 2026年11月20日確認の現行ティア別出力料金および参照画像単価。
- reAPI, Tasks API reference — 非同期タスクのポーリング、終了ステータス、エラーハンドリング。