ToAPIsToAPIs
Kling Image 4.0

Kling Image 4.0 圖片生成

使用 Kling Image 4.0 從文字生成圖片或依參考圖編輯, 支援 2K、4K 和 8K 單張輸出

POST
/v1/images/generations

中國大陸用戶請注意: 中國大陸用戶請使用 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_KEY

Body

以 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"
      }
    ]
  }
}