Image
Kling Image 4.0 Long Image
使用 Kling Image 4.0 Long Image 生成 1K 或 2K 直式電商詳情頁與網頁視覺設計,接著輪詢取得完成後的 PNG 網址。
將 JSON 請求傳送至 POST /v1/images/generations,並使用模型 ID kling-image-4-0-long-image。請保存回傳的任務 ID,接著輪詢 GET /v1/tasks/{id},直到單張直式 PNG 生成完成。
快速範例
此請求會根據文字簡述建立一張 1K 網頁版面。請將 API 金鑰存放在 SEEDROUTER_API_KEY 環境變數中。
curl 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 tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'端點與標頭
將 JSON 傳送至 POST https://api.seedrouter.ai/v1/images/generations,並帶入 Content-Type: application/json 與 Authorization: Bearer YOUR_API_KEY。請務必將金鑰保存在伺服器端。
參數說明
| 欄位 | 型別 | 數值與預設值 |
|---|---|---|
model | string,必填 | kling-image-4-0-long-image |
contents | array,必填 | 一個 prompt 項目,加上對應模式的參考圖片項目。 |
contents[].type | string,必填 | prompt、refer_image(僅限 ecommerce 模式,必填 1–3 張)、style_refer_image(僅限 webpage 模式,最多 1 張),或 subject_refer_image(僅限 webpage 模式,最多 1 張)。不支援 element。 |
contents[].text | string | prompt 項目必填。純英文上限為 166,000 字元,純非英文上限為 71,000 字元;中英混排須滿足 english / 166000 + non_english / 71000 <= 1。 |
contents[].url | string | 每個圖片項目必填。可公開存取的 HTTP(S) JPEG 或 PNG 網址,檔案上限 30 MB,每邊至少 300 px,長寬比介於 2:5 至 5:2。 |
contents[].id | string | 選填,同一請求內所有圖片項目不得重複的參考 ID。可在提示詞中以 @id 引用。 |
settings.skill | string,必填 | ecommerce(電商商品詳情頁)或 webpage(網頁版面設計)。 |
settings.length | string | short(約 2–5 區)、medium(預設,約 6–10 區)或 long(約 11–18 區)。僅適用於 ecommerce;webpage 模式會忽略此欄位。 |
settings.resolution | string | 1k(預設,寬 1024 px)或 2k(寬 2048 px)。高度依內容自動延伸,不支援 4k。 |
options.watermark_info.enabled | boolean | 選填,僅支援設為 false。 |
電商商品詳情頁
電商模式必須提供 1 至 3 個 refer_image 項目,並在提示詞中透過各自的 id 引用對應照片。
{
"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 an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}搭配風格與主體參考圖的網頁設計
網頁模式可選填 style_refer_image(最多 1 張)與 subject_refer_image(最多 1 張)。使用網頁模式時請省略 settings.length。
{
"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 watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}取得生成的長圖
將 POST 回應中的 id 存入 TASK_ID,並持續輪詢直到狀態變為 completed 或 failed。長圖任務通常需要數分鐘完成,特別是 long 搭配 2k 的版面。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"任務完成後,請讀取 output.data[0].url。每次請求會產出一張完整的直式 PNG;在 2k 規格下,長頁檔案可能超過 50 MB,請事先規劃下載逾時設定與預覽縮放處理。詳情請參閱任務參考文件與錯誤代碼目錄。
計費方式
每次成功的請求皆按所選輸出級距計費(ecommerce 依 resolution × length 計費,webpage 依 resolution 計費),另依每張輸入圖片加計參考圖片費用(從第一張起算)。請求失敗不會收費。請查看即時費率。
錯誤與使用建議
格式錯誤的請求會在扣款前回傳 HTTP 400。常見驗證錯誤包含:漏填 settings.skill、在 ecommerce 模式未提供 1–3 個 refer_image 網址、在 webpage 模式混用 refer_image、指定不支援的 4k 解析度,或重複使用相同的參考圖片 ID。
建議在提示詞中由上至下寫明完整區塊順序(從主視覺橫幅一路到規格表或頁尾),並只放入經核實的商品資訊,讓整頁內容維持準確一致。你也可以前往 Kling Image 4.0 Long Image Playground 測試提示詞,或查閱 OpenAPI 規格檔。
