Kling Image 4.0 長圖生成
以 1K 或 2K 生成網頁設計或電商商品詳情長圖
中國大陸用戶請注意: 中國大陸用戶請使用 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_KEYBody
以 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. 中國大陸價目加上 ®ion=cn, 國際價目加上 ®ion=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"
}
]
}
}