Kling Image 4.0 圖片生成
使用 Kling Image 4.0 從文字生成圖片或依參考圖編輯, 支援 2K、4K 和 8K 單張輸出
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址 (Base URL).文檔示例中的 https://toapis.com 請替換為 https://toapis.cn.
使用 kling-image-4.0 從文字生成圖片, 或提供最多 10 張參考圖來編輯、合成. 每次請求會非同步產生一張圖片, 支援 2K、4K 和 8K.
Authorizations
Authorizationstring請求頭必填所有接口均需要使用 Bearer Token 進行認證
獲取 API Key: 訪問 API Key 管理頁面 獲取您的 API Key
使用時在請求頭中添加:
Authorization: Bearer YOUR_API_KEYBody
以 application/json 送出請求, 下列參數均放在請求主體的最上層.
modelstring請求體必填預設值: kling-image-4.0固定為 kling-image-4.0.
promptstring請求體必填描述要產生的畫面, 或指定要如何修改參考圖. 請填入非空白文字.
resolutionstring請求體預設值: 2K解析度可選 2K, 4K 或 8K, 不限大小寫.
aspect_ratiostring請求體預設值: auto輸出的長寬比. auto 由模型決定. 固定比例支援 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.
sizestring請求體aspect_ratio 的別名, 可填入相同的比例值. 同時傳入時, 兩個欄位的值須一致.
ninteger請求體預設值: 1生成數量, 固定為 1. 可省略此欄位. 傳入時只接受整數 1.
image_urlsstring[]請求體最多 10 張參考圖. 可在提示詞中依陣列順序用 @image_1, @image_2 等指定各張圖的用途. 每個項目須為服務可存取的 HTTP 或 HTTPS 圖片網址. 本機檔案可透過上傳圖片 API取得網址.
參考圖支援 JPG、JPEG 或 PNG. 每張上限為 30 MB, 寬和高均須至少 300 像素, 長寬比介於 2:5 和 5:2.
reference_imagesstring[]請求體image_urls 的別名, 選用其中一個欄位.
callback_urlstring請求體選填的任務結束通知網址. 使用已設定的 Token 任務 Webhook 時, 網址須與預設網址使用相同的通訊協定、主機和連接埠. 省略時使用該 Token 已啟用的預設網址.
參數限制
此介面只產生單張標準圖片. 請省略 Kling 原生欄位 contents, options, settings, result_type 和 series_amount.
查詢工作
收到 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"計費
按請求計費, 費率依帳戶的定價區域和解析度而異. 長寬比和參考圖數量不影響費率. 請參閱任務用量和實際扣款.
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",
"prompt": "紅白相間的燈塔立在海邊礁石上, 海霧剛散, 清晨的側光照亮浪花.",
"resolution": "2K",
"aspect_ratio": "16:9"
}'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",
"prompt": "保留 @image_1 檯燈的造型和材質, 將檯燈放入 @image_2 的書房, 讓光線和陰影融入原本的場景.",
"resolution": "4K",
"aspect_ratio": "4:3",
"image_urls": [
"https://example.com/lamp.png",
"https://example.com/study.jpg"
]
}'響應示例
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0.png"
}
]
}
}