Claude Opus 5.5 已在 SeedRouter 上線

Kling Image 4.0 Long Image 教學

用 Kling Image 4.0 Long Image 打造 2K 網頁版面與電商詳情頁。本文包含兩次實測直式 PNG 成果、cURL 請求範例、輪詢步驟與即時費率。

以 Markdown 閱讀

一般的圖片生成模型一次只能產出單張畫面。如果要做一份電商詳情頁或完整產品發表網頁,往往得先拆成六張零散橫幅分別生成,再進排版軟體慢慢修補對不齊的邊距、跑掉的字體,以及忽大忽小的商品比例。Kling Image 4.0 Long Image 的做法截然不同:單次 API 請求就會從頭到尾繪製出一張連貫的直式 PNG,寬度固定為 1K(1024 px)或 2K(2048 px),高度則依提示詞規劃的區塊自動延伸。

我們在 2026 年 11 月 19 日透過 SeedRouter 的 /v1/images/generations 端點實測了兩筆 2K 任務,以貼近實務的簡述驗證兩種模式。第一筆採用純文字的 webpage 模式,替虛構的監聽耳機品牌產出一張 2048 × 16385 px 發表頁(17 MB,耗時 169 秒)。第二筆切換為 ecommerce 模式、長度設為 medium,搭配兩張既有珠寶參考照,產出一張 2048 × 19533 px 電商詳情頁(25 MB,耗時 261 秒)。下方可直接檢視兩張全頁展圖,你也可以在 Kling Image 4.0 Long Image Playground 載入這兩組簡述親自試跑,並於文末即時價格表確認各級距費率。

動手寫請求前,先決定 ecommerce 還是 webpage

settings.skill 是必填欄位,而且不只影響視覺排版邏輯,更會決定 API 接受哪些參數。請直接把兩種模式當成兩份不同的介面契約,而不是單純的風格濾鏡。

當手上已有商品實拍,需要替自家官網商店或電商平台上架直式商品詳情頁(PDP)時,請選 ecommerce。在 ecommerce 模式下,contents 裡必須包含 1 至 3 個 refer_image 項目,並透過 settings.length 控制縱向區塊深度(可選 short、medium 或 long,預設為 medium)。如果未附任何產品參考圖,請求會在扣款前直接被拒絕。

當目標是品牌形象頁、新品發表頁或雜誌感網頁視覺提案時,則選用 webpage。在 webpage 模式下,參考圖為選填:你可以純靠文字提示詞生成,也可以最多提供一張 style_refer_image 來定調配色與版面節奏,並最多提供一張 subject_refer_image 固定焦點商品外觀。切記不要在 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 項目必填:1 至 3 個公開 JPEG/PNG 網址不允許使用
style_refer_image / subject_refer_image不允許使用選填:各最多 1 張

兩種模式都不支援 4k、批次生成張數(n)或自訂長寬比。每筆成功完成的任務都會在 output.data[0].url 回傳單一張直式 PNG 網址。

實測 1:純文字 2K 網頁版面(2048 × 16385)

2048 × 16385 Solstice Audio S-01 Reference Planar 發表網頁四欄式全覽圖

上圖將 webpage 2K 實測成果均分為四段並排呈現。這組簡述要求替開放式平面振膜耳機 S-01 Reference Planar 打造一款黑曜石深色調、瑞士工業風的旗艦發表頁:精簡頂部導覽列、四分之三側面主視覺棚拍圖、三欄聲學亮點帶、CNC 切削剖面圖、帶真實電氣數值的技術規格表,以及沉靜俐落的頁尾。

仔細看這趟單次生成留住了哪些細節。在長達 16,385 像素的直向畫面上,深炭灰底色、襯線大標與髮絲紋鋁合金耳機造型從頁首一路連貫到五色陳列區與規格表。所有指定的電氣參數都清晰可讀(106 mm Iso-Planar、32 Ohms、98 dB/mW、8 Hz–52 kHz、410 g)。不過放大至 100% 檢視原始 PNG 時,也發現一個值得留意的落差:提示詞原本要求規格表改用淺象牙白底色區隔,但模型把規格表留在深岩灰底上,反而把淺灰背景套用到下方的電子報訂閱區。若特定區塊的背景切換在前端交付規格中不容妥協,建議把成品定位為視覺美術稿,再擷取生成的產品圖來切版重建 HTML 區塊。

撰寫好用的 webpage 簡述,其實更像在寫線框稿大綱,而不是一般單圖提示詞。先把全域設計 Token 寫在最前面(背景色碼、材質質感、強調色、格線紀律),再由上至下替每個區塊編號,並把標題文案與關鍵數字寫死。標題寫得太籠統,模型很容易自行填入多餘的裝飾文字。

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:雙參考圖 2K 電商詳情頁(2048 × 19533)

2048 × 19533 植物金飾耳環電商詳情頁四欄式全覽圖

第二筆實測將 settings.skill 切換為 "ecommerce",settings.length 設為 "medium",解析度維持 "2k",並在 refer_image 傳入兩張既有珠寶攝影:一張標記為 id: "earring" 的立體黃金蘭花垂墜耳環微距照,以及一張標記為 id: "model"、女子於玻璃溫室配戴同款耳環的時尚人像。

在提示詞的各個區塊裡,我們直接用 @earring 與 @model 點名這兩張素材。API 會自動將具名 ID 對應成位置索引,不需要人工計算順序。請留意每張參考照片都必須是可公開存取的 JPEG 或 PNG 網址,單檔上限 30 MB,長短邊至少 300 px,長寬比介於 2:5 到 5:2 之間。

取自 2K 電商詳情頁的 Craft And Beauty 工藝標註解析區塊

這一次中版 2K 請求就產出高達 19,533 像素的直式長圖,完整涵蓋六個電商模組:溫潤香檳絲綢主視覺、設計靈感引言區、乾淨白底去背圖搭配六列商品資訊表(Phalaenopsis No. 4 Drop Earring、18K Recycled Yellow Gold、48 mm drop length、Forest-green velvet presentation box)、忠實還原 @model 的 On The Ear 配戴人像、六視角商品方格(Front、Side、Back、Core Detail、Hook Detail、Profile),以及上方局部放大的 Craft And Beauty 工藝標註解析圖。

不過在原圖解析度下逐區檢查時,也抓出一個正式上架前必須注意的瑕疵:雖然商品資訊表精準印出了 Phalaenopsis No. 4 Drop Earring,各項工藝標註也沒有拼錯字,但頂部主視覺橫幅把 Botanical Series 縮短成 BOTA SERIES 與 BOTA — Drop Earring,並未完整印出提示詞指定的品牌名 L'ORCHIDÉE。這是長圖文字生成很典型的現象——簡短內文標籤與規格列相當穩定,但具高度裝飾性的全大寫品牌主標偶爾會偏移。正式發布前務必以 100% 寬度檢查主視覺標題,至於攸關法規或商標精準度的品牌 Logo 與聲明小字,仍建議在商店版型中以向量圖層疊加。

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.json

如果改在 webpage 模式下搭配參考圖,請記得對應規則:用 style_refer_image 指定美學風格、用 subject_refer_image 指定焦點商品,替各自設定 1 至 32 字元、不含空白的英數字 id,再於提示詞中寫入 @id。同一份 contents 陣列內切勿出現重複的 ID。

耐心輪詢,並為大型 2K PNG 下載預留緩衝

直式長頁的運算時間比一般單張圖片明顯更長,成品檔案也龐大得多。若沿用五秒縮圖 API 的逾時思維來呼叫,最容易遇到用戶端逾時中斷,甚至因自動重試造成重複扣款。

以我們 11 月 19 日的兩次實測為例,2048 × 16385 網頁版面花了 169 秒(17 MB),2048 × 19533 中版電商詳情頁花了 261 秒(25 MB);若是長版 2K 電商詳情頁,耗時可能超過七分鐘、檔案大小破 50 MB。呼叫 POST /v1/images/generations 拿到回應後請立即保存任務 ID,接著每 15 至 20 秒輪詢 GET /v1/tasks/{id} 一次,千萬不要因為終端機斷線或請求逾時就重複送出第二次 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.json

當 status 回傳 completed 時,從 output.data[0].url 取出單張 PNG 網址,並設定充裕的傳輸逾時將檔案串流寫入磁碟:

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 回應主體串流寫入本機檔案或物件儲存空間,先檢查實際尺寸再依區塊裁切供行動版商店載入;前端預覽圖轉成 WebP 以節省流量,原始 PNG 則留存作為印刷或重新切圖的母檔。

掌握八種輸出級距與參考圖片的預算配置

Kling Image 4.0 Long Image 的費用取決於三個選項:skill(ecommerce 或 webpage)、length(電商模式專屬的 short、medium、long)與 resolution(1k 或 2k)。每附上一張參考圖片(無論是 refer_image、style_refer_image 或 subject_refer_image)皆會加計一次輸入圖片費用,從第一張起算、不設免費額度。

這套計價結構讓提案與量產的分工非常直覺。替電商商品反覆調整區塊順序、標題節奏與色彩層次時,先用 1k 搭配 short 或 medium 試跑,確認縱向閱讀流暢後再切至 2k 輸出成品。至於 webpage 模式,1k 與 2k 的價差相當小,只要頁面裡有細節較多的小字規格表,通常直接選 2k 更划算。我們的第一筆實測依 webpage 2K 費率計費;第二筆實測依 ecommerce medium 2K 費率另加兩張輸入圖片計費。請求失敗不會收費。你可以在下方檢視即時費率,或將實際輸入條件填入 Kling Image 4.0 Long Image 價格試算工具。[3]

Kling Image 4.0 Long Image 計費方式

類別價格 (USD)
電商模式 · 1K · shortUS$0.2269
電商模式 · 2K · shortUS$0.2723
電商模式 · 1K · mediumUS$0.4538
電商模式 · 2K · mediumUS$0.5294
電商模式 · 1K · longUS$0.7563
電商模式 · 2K · longUS$0.8319
網頁模式 · 1KUS$0.5294
網頁模式 · 2KUS$0.5748
參考圖片US$0.003025

常見問題

在 ecommerce 模式下,該怎麼選擇 short、medium 與 long?

選定 length 前,先盤點這項商品實際需要幾個獨立模組。short 適合三到四個精簡區塊,例如主視覺、核心賣點與精要規格;medium 能從容容納六個左右的完整區塊,像上方珠寶實測就涵蓋主視覺、設計故事、白底去背、規格表、情境配戴照、多角度方格與工藝標註圖;long 則留給精密硬體或多規格商品,需要放入比較圖表、步驟教學與包裝內容物拆解,同時不想讓文字顯得擁擠時再選用。

為什麼我的 webpage 請求回傳 HTTP 400?

最常見的兩個驗證錯誤,是在 skill: "webpage" 時多傳了 settings.length,或是把參考圖標記為 type: "refer_image" 而非 style_refer_image / subject_refer_image。這兩項設定都只屬於 ecommerce 模式。此外,請確認提示詞在對應 @id 之後仍符合加權字元上限(en / 166000 + non_en / 71000 <= 1),且 resolution 只填 "1k" 或 "2k"。

上架到實際電商網站前,需要把生成的 PNG 切圖嗎?

需要。一張 2048 × 19533 的未壓縮 PNG 約落在 17 至 25 MB,直接用單一 <img> 標籤放上行動網路會拖垮載入速度。實務上請沿著水平區塊邊界切分成數張圖段,各自轉檔壓縮為 WebP 或 AVIF 以支援漸進式載入,並把重要商標、售價與購買按鈕換成真正的 HTML 文字與元件。在串接自動化流程前,你可以先到 Kling Image 4.0 Long Image Playground 測試提示詞並檢視全高成品。

參考來源

  1. SeedRouter Kling Image 4.0 Long Image API 參考文件
  2. SeedRouter 任務輪詢與結果取得指南
  3. Kling Image 4.0 Long Image 即時價格與試算工具

相關指南