Kling Image 4.0 Long Image API:EC 商品詳細・縦長 Web ページ実装
Kling Image 4.0 Long Image API で 1K・2K の縦長 EC 詳細ページと Web デザインを生成。2 スキルの仕様、8 料金ティア、タイムアウト設計を解説。
Markdown で読む標準的な画像生成 API に、縦長スクロール型の EC 商品詳細ページや複数セクションのランディングページ案を依頼すると、たちまち限界にぶつかります。アスペクト比は 9:16 や 21:9 が上限で、分割生成すると書体がぶれ、バナー同士を手作業でつなぐと継ぎ目が目立ちます。Kling Image 4.0 Long Image(kling-image-4-0-long-image)はまさにこの課題を解決するモデルで、1 回の POST /v1/images/generations 呼び出しから一貫性のある縦長 PNG 全体を一括レンダリングします。
2K・4K の独立静止画や複数カットのシリーズを出力する Kling Image 4.0 とは異なり、Long Image エンドポイントは ecommerce と webpage の 2 つの専用レイアウトスキルを軸に設計されており、それぞれ固有のリファレンス画像種別・長さ設定・ティア料金を持ちます。2026 年 11 月下旬時点でも、検索結果の多くは本モデルを Kling 動画や汎用アップスケーラーと混同しています。本ガイドでは、検証済みの API 仕様、全料金ティア、厳密なバリデーション規則、数分かかるレンダリングと 50 MB 超の PNG ダウンロードを安定処理するための本番設計を解説します。
2 つのスキルと厳格な入力仕様
kling-image-4-0-long-image へのすべてのリクエストは settings.skill に ecommerce または webpage を指定する必要があります。モード間でリファレンス種別を混在させると、課金前に HTTP 400 バリデーションエラーが返ります。
| 項目・ルール | skill: "ecommerce" | skill: "webpage" |
|---|---|---|
| 主な成果物 | 縦長商品詳細ページ(PDP) | フルスクロール Web ページデザイン |
| リファレンス種別 | refer_image(必須:1〜3 枚の写真) | style_refer_image(0–1 枚)および subject_refer_image(0–1 枚) |
| 参照なしテキスト単体呼び出し | 拒否(HTTP 400) | 許可 |
settings.length | short(約 2–5 区画)、medium(デフォルト、約 6–10)、long(約 11–18) | 無視(省略する) |
settings.resolution | 1k(幅 1024 px、デフォルト)または 2k(幅 2048 px) | 1k(幅 1024 px、デフォルト)または 2k(幅 2048 px) |
4k 解像度 | 非対応(HTTP 400) | 非対応(HTTP 400) |
| 出力枚数 | 常に縦長 PNG 1 枚(output.data[0].url) | 常に縦長 PNG 1 枚(output.data[0].url) |
リファレンス画像 URL はすべて公開アクセス可能な HTTP(S) の JPEG または PNG で、30 MB 以下、各辺 300 ピクセル以上、幅対高さの比率が 2:5〜5:2 である必要があります。なお kling-image-4-0-long-image は element リファレンス非対応です。
プロンプト容量は一般的な画像生成モデルと比べて非常に大きく、英語最大 166,000 文字、非英語最大 71,000 文字(混在時は english / 166000 + non_english / 71000 <= 1)まで受け付けます。この余裕を活かし、モデルに仕様を創作させるのではなく、セクションごとの確定コピー・検証済みスペック表・成分一覧・注釈ラベルをそのまま渡せます。
リアルタイム料金ティアとリファレンス課金
完了した Long Image タスクは、skill・resolution・(ecommerce のみ)length で決まる固定ティア料金 1 回分に、1 枚目を含む入力写真ごとのリファレンス料金を加算して課金されます。失敗や無効リクエストは無料です。
Kling Image 4.0 Long Image の料金
| カテゴリ | 料金 (USD) |
|---|---|
| EC · 1K · ショート | $0.2269 |
| EC · 2K · ショート | $0.2723 |
| EC · 1K · ミディアム | $0.4538 |
| EC · 2K · ミディアム | $0.5294 |
| EC · 1K · ロング | $0.7563 |
| EC · 2K · ロング | $0.8319 |
| Web ページ · 1K | $0.5294 |
| Web ページ · 2K | $0.5748 |
| リファレンス画像 | $0.003025 |
2026 年 11 月 20 日に https://api.toklab.ai/v1/pricing で確認した 8 出力ティアの内訳は以下の通りで、入力リファレンス画像 1 枚につき $0.003025 が加算されます:
| スキル | 長さ | 解像度 | 出力レート | リファレンス 2 枚時の例 |
|---|---|---|---|---|
ecommerce | short(約 2–5 セクション) | 1k | $0.2269 | $0.23295 |
ecommerce | short(約 2–5 セクション) | 2k | $0.2723 | $0.27835 |
ecommerce | medium(約 6–10 セクション) | 1k | $0.4538 | $0.45985 |
ecommerce | medium(約 6–10 セクション) | 2k | $0.5294 | $0.53545 |
ecommerce | long(約 11–18 セクション) | 1k | $0.7563 | $0.76235 |
ecommerce | long(約 11–18 セクション) | 2k | $0.8319 | $0.83795 |
webpage | 該当なし | 1k | $0.5294 | $0.53545 |
webpage | 該当なし | 2k | $0.5748 | $0.58085 |
1K から 2K への差額に注目してください。webpage ではわずか $0.0454(+8.6%)、ecommerce の medium や long でも $0.0756(+10%〜+16.7%)の追加にとどまります。縦長ページには小さな UI ラベル・仕様表・本文コピーが密集するため、本番アセットにはほぼ常に 2k(幅 2048 px)が有利です。一方 1k はセクション構成を固める前の安価な下書きとして有効です。

EC モードと Web ページモードのプロンプト構成法
モデルが 1 パスで縦長ページ全体を組み上げるため、曖昧なプロンプトでは冗長なセクションの反復やスペックの捏造が起きやすくなります。プロンプトをワイヤーフレーム仕様書のように書くことで品質が大きく向上します:
- 上から下へ厳密な順番でセクションを列挙する。 たとえば
Section 1: Hero banner、Section 2: 3-column feature callouts、Section 3: Macro texture detail、Section 4: Specification table、Section 5: Care instructions and footerのように番号を明示します。 - 各参照写真を
@idで紐づける。ecommerceモードではfront・spout・boxなど明確な ID を割り当て、どの帯にどの角度を置くか指示します。webpageモードでは見た目(style_refer_imageの@layout)と主役商品(subject_refer_imageの@product)を分離します。 - 正確なコピーと数値を支給する。 「リアルな技術仕様を追加して」とは書かず、ワット数・寸法・素材・見出しをそのまま記述すれば、後から誤記を修正する手間が省けます。
settings.lengthとセクション数を一致させる。length: "short"に 14 個の詳細帯を詰め込むと文字が潰れます。2–5 区画はshort、6–10 区画はmedium、11–18 区画はlongを組み合わせてください。
最適な EC 長さティアの選び方
short・medium・long の選択は、視覚的なテンポと予算管理の両面に関わります。short(約 2–5 セクション、1k で $0.2269・2k で $0.2723)は、ヒーロー写真・3 つの訴求ポイント・簡潔な仕様枠だけで十分な単一 SKU 販促カードやモバイル向けティザーに適しています。medium(約 6–10 セクション、1k で $0.4538・2k で $0.5294)は Shopify・Amazon A+・越境 EC ストアの多くにとって実用的な標準で、ヒーロー・素材クローズアップ・使用シーン・寸法表・同梱物一覧を過不足なく収められます。
long(約 11–18 セクション、1k で $0.7563・2k で $0.8319)は、ストーリー帯・分解パーツ注釈・手順ガイド・認証バッジ・FAQ まで必要なフラッグシップ家電や複数バリエーションキット向けに限定するのが賢明です。11 区画以上を埋める独自情報が不足している場合、long モードは既存アングルの焼き直しや汎用バナーを増やしがちで、待ち時間と予算の両方を浪費します。
Web ページモードでスタイル参照と被写体参照を分ける理由
webpage モードで style_refer_image と subject_refer_image を分けることで、単一バケット型リファレンス API にありがちな失敗——他社ブランドの商品が混入する、あるいは商品写真の雑多な背景がサイト UI へ紛れ込む現象——を防げます。エディトリアル画面のスクリーンショットや Figma フレームを style_refer_image に渡すとグリッドリズム・カラートークン・見出し階層・ボタン意匠のみが参照され、スタジオ撮影の商品写真を subject_refer_image に渡すとヒーローから機能カードまで実物形状が忠実に維持されます。テキストのみでオリジナルのアートディレクションを行いたい場合は両フィールドを省略し、配色・フォント組・グリッド構造をプロンプトで直接記述してください。
生成ページ公開前の品質チェック
2k 解像度であっても、ストア公開やクライアント提示の前に自動+目視の簡易 QA を通すことが重要です。まず、描画された数値・単位・成分表記を元プロンプトと突き合わせます。高密度な仕様表の小さな文字崩れは縮小プレビューより 100% 表示の方が見つけやすいものです。次に、ボタン配置・ロゴ・ポート・比率といった商品の物理形状がヒーロー帯からクローズアップまで一貫しているか確認します。最後に、スライス後の画像を 390 px のモバイル画面幅で視認性チェックします。幅 2,048 px では鮮明に見えるデスクトップ向け 4 カラム行もスマホでは読めなくなるため、最初から高コントラストの 2 カラムまたは縦積みモバイルカードを指定しておくと安全です。
両スキルの完全なリクエスト例
1. EC 商品詳細ページ(medium、2k)
{
"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": "Design a clean ecommerce product detail page for the matte black gooseneck kettle in @front. Section 1: Hero banner with headline 'Precision Pour 0.9L' and @front centered on warm stone. Section 2: Three feature cards covering 1200W rapid boil, 1-degree PID control, and 60-minute hold. Section 3: Macro close-up based on @spout highlighting laminar flow control. Section 4: Lifestyle pour-over brewing scene. Section 5: Dimension and electrical spec table (900 ml, 1200W, 120V, 304 stainless steel). Section 6: Box contents and care notes."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}2. スタイル+被写体リファレンス付き Web ページデザイン(2k)
import os
import time
import requests
API_KEY = os.environ["TOKLAB_API_KEY"]
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
payload = {
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "grid"},
{"type": "subject_refer_image", "url": "https://example.com/chronograph.jpg", "id": "watch"},
{
"type": "prompt",
"text": (
"Create a vertical product launch webpage adopting the Swiss editorial grid, "
"high-contrast serif headings, and generous whitespace of @grid while featuring @watch. "
"Include: top navigation bar, full-bleed hero with @watch, three-card movement breakdown, "
"water-resistance specification band, and minimalist footer."
),
},
],
"settings": {"skill": "webpage", "resolution": "2k"},
}
resp = requests.post(
"https://api.toklab.ai/v1/images/generations",
headers=HEADERS,
json=payload,
timeout=60,
)
resp.raise_for_status()
task_id = resp.json()["id"]
# Poll every 5s; long 2K layouts can take several minutes.
deadline = time.time() + 600
while time.time() < deadline:
status_resp = requests.get(
f"https://api.toklab.ai/v1/tasks/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
status_resp.raise_for_status()
data = status_resp.json()
if data.get("status") == "completed":
png_url = data["output"]["data"][0]["url"]
print("Ready:", png_url)
break
if data.get("status") == "failed":
raise RuntimeError(f"Long image task failed: {data}")
time.sleep(5)本番運用の注意点:タイムアウト・50 MB 超 PNG・スライス配信
kling-image-4-0-long-image をバックエンドに組み込む際は、高速な 1024×1024 画像生成モデルとは異なる 3 つの運用配慮が必要です:
- 数分単位のタスク実行時間を前提にする。
long+2kの EC レンダリングは数分かかるのが普通です。30 秒タイムアウトのサーバーレス関数やブラウザから同期待機せず、タスク ID をバックグラウンドワーカーへ投入し、上限 10 分程度でGET /v1/tasks/:idをポーリングしてください。 - 大容量 PNG はストリーミングダウンロードする。
2k縦長画像は幅 2,048 px に対して縦が 10,000〜20,000 px 超に及ぶため、完成 PNG が 50 MB を超えることがあります。十分な読み取りタイムアウトを設定したストリーミング取得(requests.get(url, stream=True))を使い、小さなコンテナのメモリ上で複数ビットマップを同時に展開しないよう注意します。 - 本番ストア向けにスライス&再エンコードする。 Shopify・Amazon A+・Taobao/Tmall などの EC 基盤やモバイルブラウザは単一 50 MB の PNG 配信に不向きです。検品完了後、マスター PNG をセクション境界で分割し、各スライスを品質 80〜85% の WebP またはプログレッシブ JPEG へ変換して配信してください。
事前に防ぐべき代表的な HTTP 400 エラー
エンドポイント呼び出し前に次の 5 点をバリデーションしておきます:
settings.skillの欠落("ecommerce"または"webpage"が必須)。skill: "ecommerce"でrefer_imageが 0 枚または 4 枚以上。webpageモードでrefer_imageを渡す、またはecommerceモードでstyle_refer_image/subject_refer_imageを渡す。resolution: "4k"の指定(Long Image は"1k"と"2k"のみ対応)。contents内の複数リファレンスで同一のid文字列を重複使用する。
横長・正方形のキャンペーン静止画、商品のライフスタイルセット、1 枚に最大 10 枚のリファレンス合成が必要なジョブは Kling Image 4.0 へ振り分け、Kling Image 4.0 Long Image は縦長マルチセクションのページ構成に専念させるのが最適です。
情報源
- TokLab Kling Image 4.0 Long Image モデルページ — インタラクティブ Playground、最新 1K/2K ティア表、料金計算機。
- TokLab Kling Image 4.0 Long Image API リファレンス — 公式スキーマ、文字数上限、バリデーション制約。
- TokLab リアルタイム料金 API — 2026 年 11 月 20 日確認済みの機械可読料金フィード。


