Kling Image 4.0 Long Image API:電商詳情頁與網頁長圖實戰
使用 Kling Image 4.0 Long Image API 生成 1K 與 2K 直式電商詳情頁與網頁設計,完整涵蓋雙技能規格、定價級距與逾時處理。
以 Markdown 閱讀一旦你想讓一般生圖 API 產出完整的直式捲動電商商品詳情頁,或是多區塊的著陸頁視覺稿,傳統模型立刻就會捉襟見肘:畫面比例頂多到 9:16 或 21:9,分段生成的字體風格彼此飄移,手動拼接獨立橫幅又會留下明顯接縫。Kling Image 4.0 Long Image(kling-image-4-0-long-image)正是為此而生,只要呼叫一次 POST /v1/images/generations,就能將整份直式版面渲染成一張連貫的長圖 PNG。
不同於輸出獨立 2K/4K 靜態圖與多鏡頭系列的 Kling Image 4.0,Long Image 端點圍繞 ecommerce 與 webpage 兩項專用版面技能建構,各自擁有獨立的參考圖類型、長度控制與分級定價。截至 2026 年 11 月下旬,多數搜尋結果仍將此模型與 Kling 影片或一般圖片放大工具混淆。本指南整理經實測確認的 API 規格、所有定價級距、真實參數驗證規則,以及處理數分鐘算圖與 50 MB 以上 PNG 下載的正式環境工程細節。
兩種技能,兩套嚴格輸入規格
每一筆送往 kling-image-4-0-long-image 的請求都必須將 settings.skill 宣告為 ecommerce 或 webpage。若混用兩種模式的參考圖類型,系統會在計費前直接回傳 HTTP 400 驗證錯誤。
| 欄位/規則 | skill: "ecommerce" | skill: "webpage" |
|---|---|---|
| 主要交付成果 | 直式商品詳情頁(PDP) | 完整捲動式網頁視覺設計 |
| 參考圖項目類型 | 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) |
| 輸出數量 | 固定 1 張直式長圖 PNG(output.data[0].url) | 固定 1 張直式長圖 PNG(output.data[0].url) |
每張參考圖 URL 都必須是公開可存取的 HTTP(S) JPEG 或 PNG,檔案大小上限 30 MB,每邊至少 300 像素,寬高比介於 2:5 至 5:2。請注意,kling-image-4-0-long-image 不支援 element 參考圖。
相較於一般生圖模型,Long Image 的提示詞容量格外充裕:最多支援 166,000 個英文字元或 71,000 個非英文字元(混合語系須滿足 english / 166000 + non_english / 71000 <= 1)。這樣的餘裕正是為了讓你放入完整的逐區文案、核實過的規格表、成分清單與標註文字,避免模型自行杜撰商品數據。
即時定價級距與參考圖計費方式
每筆完成的 Long Image 任務會收取一筆固定級距費用——由 skill、resolution 以及(ecommerce 模式下的)length 決定——再加上每張輸入照片(從第一張起算)的參考圖費。失敗或參數無效的請求不收費。
Kling Image 4.0 Long Image 費用說明
| 類別 | 價格 (USD) |
|---|---|
| 電商模式 · 1K · 短 | $0.2269 |
| 電商模式 · 2K · 短 | $0.2723 |
| 電商模式 · 1K · 中 | $0.4538 |
| 電商模式 · 2K · 中 | $0.5294 |
| 電商模式 · 1K · 長 | $0.7563 |
| 電商模式 · 2K · 長 | $0.8319 |
| 網頁模式 · 1K | $0.5294 |
| 網頁模式 · 2K | $0.5748 |
| 參考圖片 | $0.003025 |
依 2026 年 11 月 20 日在 https://api.toklab.ai/v1/pricing 核實的數據,八個輸出級距的明細如下,每張輸入參考圖另加 $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%)。由於直式長圖塞滿細小的介面標籤、規格表格與正文文字,最終成品幾乎都值得升級至 2k(寬 2048 px),而 1k 則很適合在鎖定區塊大綱前做低成本版面草稿。

撰寫電商與網頁模式提示詞的結構技巧
因為模型會在單次渲染中排版整份捲動頁面,模糊的提示詞容易導致重複灌水區塊或捏造規格。把提示詞當成線框圖規格書來寫,版面品質會大幅提升:
- 依由上而下的精確順序列出各區塊。 為每個橫幅明確編號,例如:
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模式中指定清楚的 ID(front、spout、box),並告訴模型哪個區塊該放哪個角度;在webpage模式中將視覺風格(透過style_refer_image傳入@layout)與焦點商品(透過subject_refer_image傳入@product)分開。 - 提供精確文案與數字。 切勿寫「補上逼真的技術規格」,而是直接給出欲呈現的瓦數、尺寸、材質與標題,省去事後修圖修正虛構數據的麻煩。
- 讓
settings.length與區塊數相符。 在length: "short"裡硬塞 14 個細節區塊會壓縮排版導致小字模糊。請將 2–5 區對應short、6–10 區對應medium、11–18 區對應long。
如何挑選合適的電商頁長度級距
在 short、medium 與 long 之間抉擇,同時關乎視覺節奏與預算控制。short 頁面(約 2–5 區,1k 為 $0.2269、2k 為 $0.2723)適合單一 SKU 促銷卡片、手機優先的賣場預告頁與對照條,買家只需主視覺、三個賣點與精簡規格塊。medium 頁面(約 6–10 區,1k 為 $0.4538、2k 為 $0.5294)是多數 Shopify、Amazon A+ 與跨境電商詳情頁的實務甜蜜點,能容納主視覺、材質特寫、使用情境、尺寸表與盒裝內容,又不會拉得過於空泛。
long 頁面(約 11–18 區,1k 為 $0.7563、2k 為 $0.8319)則建議留給旗艦消費電子、家電或多規格套組,確實需要品牌敘事區塊、爆炸結構標註圖、分步操作指南、認證徽章與 FAQ 區塊時再使用。如果手邊商品資訊不足以撐起 11 個以上獨立區塊,long 模式往往會重複先前角度或編造制式情境橫幅,徒增算圖時間與費用。
為何網頁模式將風格與主體參考圖拆開
在 webpage 模式中,把 style_refer_image 與 subject_refer_image 分開能避免單一參考槽 API 常見的失誤:模型誤把別家品牌的商品複製進你的版面,或把商品照雜亂的背景搬進網站 UI 外框。將雜誌版面截圖或 Figma 畫框傳給 style_refer_image,可將其作用限縮在格線節奏、色彩規範、字體層級與按鈕樣式;同時將乾淨的棚拍商品照傳給 subject_refer_image,確保實體商品在主視覺與功能卡片中保持一致。如果你想純靠文字開創原創美術風格,省略兩個圖片欄位並直接在提示詞描述配色、字體搭配與格線結構即可。
上線前的生成長圖品質檢核
即使輸出 2k 解析度,生成長圖在發佈到商店或交付客戶簡報前仍應經過快速的自動化與人工目視檢核。第一,將畫面上每個數字、單位與成分文字與原始提示詞逐一核對——高密度規格表裡的細微錯字在 100% 檢視下比縮圖容易發現得多。第二,確認商品的實體幾何結構(按鍵位置、標誌、連接埠與比例)從頂部主視覺到下方特寫都維持一致。第三,切圖後在 390 px 手機視口檢查直式可讀性:在 2,048 px 寬度下看似銳利的桌機四欄卡片,在手機上可能過小難讀,除非提示詞一開始就指定粗體高對比的雙欄或堆疊式行動卡片。
兩種技能的完整請求範例
1. 電商商品詳情頁(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. 結合風格與主體參考圖的網頁視覺設計(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 生圖模型截然不同:
- 預留數分鐘的任務耗時。
long搭配2k的電商算圖常需數分鐘。切勿在瀏覽器或僅有 30 秒逾時的無伺服器函式中同步乾等,應將任務 ID 寫入背景佇列工作進程,並以 10 分鐘上限輪詢GET /v1/tasks/:id。 - 以串流方式下載大型 PNG。 由於
2k長圖寬度為 2,048 像素、高度可達 10,000 至 20,000 像素以上,成品 PNG 檔案可能超過 50 MB。請使用串流下載(requests.get(url, stream=True))搭配充裕的讀取逾時,並避免在小型容器記憶體中同時緩衝多張原始點陣圖。 - 上架前依區塊切圖並重新壓縮。 Shopify、Amazon A+、淘寶/天貓等電商平台與行動瀏覽器對單張 50 MB PNG 並不友善。確認生成版面無誤後,沿區塊邊界切分母檔 PNG,並將每個切片轉成 80–85% 品質的 WebP 或漸進式 JPEG 以加速載入。
需提前防範的五大常見 HTTP 400 錯誤
呼叫端點前請先驗證以下五項條件:
- 漏填
settings.skill(必須為"ecommerce"或"webpage")。 skill: "ecommerce"時傳入 0 張或超過 3 張refer_image。- 在
webpage模式傳入refer_image,或在ecommerce模式傳入style_refer_image/subject_refer_image。 - 請求
resolution: "4k"(Long Image 僅提供"1k"與"2k")。 - 在
contents的兩個參考圖項目重複使用相同的id字串。
如果你的工作流需要標準橫式或方形行銷圖、商品情境組圖,或單張畫面帶入最多 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 參考文件 — 官方 schema、字元上限與驗證限制。
- TokLab 即時定價 API — 2026 年 11 月 20 日核實的機器可讀費率來源。


