ToAPIsToAPIs
Kling Image 4.0

Kling Image 4.0 長圖生成

以 1K 或 2K 生成網頁設計或電商商品詳情長圖

POST
/v1/images/generations

中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址 (Base URL).文檔示例中的 https://toapis.com 請替換為 https://toapis.cn.

kling-image-4.0-long 每次非同步生成一張長圖. 網頁設計選用 webpage, 電商商品詳情選用 ecommerce.

Authorizations

Authorizationstring請求頭必填

所有接口均需要使用 Bearer Token 進行認證

獲取 API Key: 訪問 API Key 管理頁面 獲取您的 API Key

使用時在請求頭中添加:

Authorization: Bearer YOUR_API_KEY

Body

以 application/json 送出請求, 下列參數均放在請求主體的最上層.

modelstring請求體必填預設值: kling-image-4.0-long

固定為 kling-image-4.0-long.

promptstring請求體必填

填入非空白文字, 描述要生成的版面和內容.

skillstring請求體必填

webpage 生成網頁設計長圖, ecommerce 生成電商商品詳情長圖.

resolutionstring請求體預設值: 1K

支援 1K 和 2K, 不區分大小寫.

ninteger請求體預設值: 1

生成數量, 固定為 1. 可省略此欄位. 傳入時只接受整數 1.

lengthstring請求體

僅適用於 ecommerce. short 約 2-5 個內容區塊, medium 約 6-10 個 (預設), long 約 11-18 個. 所有區塊合成一張圖片.

image_urlsstring[]請求體

ecommerce 必須依序提供 1 到 3 張商品參考圖, 使用此欄位或 reference_images. 提示詞中的 @image_1, @image_2 和 @image_3 依陣列順序引用圖片.

reference_imagesstring[]請求體

ecommerce 可用此欄位代替 image_urls. 兩者只傳一個.

style_reference_image_urlstring請求體

僅適用於 webpage, 選填. 傳入一個網址, 指定用來參考視覺風格的圖片.

subject_reference_image_urlstring請求體

僅適用於 webpage, 選填. 傳入一個網址, 指定用來參考主體的圖片.

callback_urlstring請求體

選填的任務結束通知網址. 使用已設定的 Token 任務 Webhook 時, 網址須與預設網址使用相同的通訊協定、主機和連接埠. 省略時使用該 Token 已啟用的預設網址.

參考圖須使用服務可存取的 HTTP(S) 網址. 本機檔案可用上傳圖片 API取得網址.

參數限制

webpage 必須省略 length, image_urls 和 reference_images, 這些欄位即使傳入空陣列或 null 也會遭到拒絕. 兩個角色參考圖欄位皆省略時, 依純文字生成. ecommerce 必須省略 style_reference_image_url 和 subject_reference_image_url.

請省略 size, aspect_ratio, ratio, series_amount, result_type, contents, options 和 settings.

查詢工作

收到 id 後, 使用相同的 API Key 查詢圖片任務. queued 和 in_progress 表示任務仍在處理. 狀態為 completed 時讀取 result.data[0].url, 為 failed 時查看 error.

curl "https://toapis.com/v1/images/generations/TASK_ID" \
  -H "Authorization: Bearer $TOAPIS_API_KEY"

計費

基本費用按次收取, 取決於計價區域, skill 和 resolution. ecommerce 的價格也取決於 length. 使用同一把 API 金鑰查詢 GET /v1/pricing?model=kling-image-4.0-long. 中國大陸價目加上 &region=cn, 國際價目加上 &region=global. 省略時會傳回 global 價目, API 網域不影響這個預設值.

相符的價格項目若含有 input_image_unit_price, 超出 free_input_image_count 的參考圖會按張加價. 確認後的實際費用請查看工作的 billing. 詳見實際費用與工作用量.

Response

idstring

任務唯一標識符, 用於查詢任務狀態

objectstring

對象類型, 固定爲 generation.task

modelstring

使用的模型名稱

statusstring

請求受理時為 queued.

progressinteger

任務進度百分比(0-100)

created_atinteger

任務創建時間戳(Unix 時間戳)

metadataobject

任務元數據

result.data[].urlstring

任務完成後傳回的單張圖片網址.

執行範例前設定 TOAPIS_API_KEY 環境變數. 參考圖範例中的 example.com 是預留位址, 請替換為可存取的圖片 URL.

請求示例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "kling-image-4.0-long",
  "prompt": "為陶藝工作室設計長版登陸頁面. 採用風格參考圖的視覺風格, 以主體參考圖中的手工馬克杯為主角, 加上課程時間表和預約區.",
  "skill": "webpage",
  "n": 1,
  "resolution": "1K",
  "style_reference_image_url": "https://example.com/pottery-style.png",
  "subject_reference_image_url": "https://example.com/handmade-mug.png"
}'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "kling-image-4.0-long",
  "prompt": "為 @image_1 中的桌燈生成商品詳情長圖. 用 @image_2 呈現控制按鈕的特寫, 加入亮度調整, 商品尺寸與包裝內容.",
  "skill": "ecommerce",
  "n": 1,
  "resolution": "2K",
  "length": "medium",
  "image_urls": [
    "https://example.com/desk-lamp.png",
    "https://example.com/lamp-controls.png"
  ]
}'

響應示例

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0-long",
  "status": "queued",
  "progress": 0,
  "created_at": 1794960000,
  "metadata": {}
}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "kling-image-4.0-long",
  "status": "completed",
  "progress": 100,
  "created_at": 1794960000,
  "metadata": {},
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://example.com/generated/kling-image-4.0-long.png"
      }
    ]
  }
}