Image
Kling Image 4.0
使用 Kling Image 4.0 生成 2K 或 4K 圖片。為參考照片命名,生成單張圖片的不同版本或一系列彼此連貫的圖片,接著輪詢取得完成後的圖片網址。
將 JSON 請求傳送至 POST /v1/images/generations,並使用模型 ID kling-image-4-0。儲存回傳的任務 ID。同一個端點可接受純文字描述,也可接受以參考圖片為依據的描述。
快速範例
此請求會生成一張正方形的 2K 靜態圖片。請將 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",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'端點與標頭
POST https://api.seedrouter.ai/v1/images/generations 端點接收 JSON,請設定 Content-Type: application/json 和 Authorization: Bearer YOUR_API_KEY。請將金鑰保存在伺服器上。
參數
| 欄位 | 型別 | 可用值與預設值 |
|---|---|---|
model | 字串,必填 | kling-image-4-0 |
contents | 陣列,必填 | 一段提示詞與 0 到 10 張參考圖片。 |
contents[].type | 字串,必填 | prompt 或 refer_image。 |
contents[].text | 字串 | 提示詞為必填。英文內容上限為 50,000 個字元,非英文內容上限為 21,000 個字元。混合文字中,英文與非英文內容各自占其上限的比例相加不得超過 1。 |
contents[].url | 字串 | 每張參考圖片皆為必填。請使用可公開存取的 HTTP(S) 網址,圖片格式須為 JPEG 或 PNG,檔案大小上限為 30 MB。圖片的寬與高都至少須為 300 像素,寬高比須介於 2:5 到 5:2 之間。 |
contents[].id | 字串 | 參考圖片可選用不重複的名稱。在提示詞中以 @name 提及該名稱。 |
settings.result_type | 字串 | single(預設),適用於彼此獨立的圖片;或使用 series 生成彼此相關的圖片。 |
settings.n | 整數 | 生成 1–9 張彼此獨立的圖片。預設為 1。僅在 single 模式下使用。 |
settings.series_amount | 整數或字串 | 在 series 模式下生成 2 到 10 張圖片,預設為 4。若使用 5 到 10 張圖片,提示詞最多支援 20,000 個字元,且必須以名稱或 @name 提及每張參考圖片。每張參考圖片都必須清晰可讀,且不得超過 20 MB。在 single 模式下會忽略此欄位,可填入 2 到 10 的整數或字串 auto。 |
settings.resolution | 字串 | 2k(預設)或 4k。 |
settings.aspect_ratio | 字串 | auto(預設)、16:9、9:16、1:1、4:3、3:4、3:2、2:3 或 21:9。 |
options.watermark_info.enabled | 布林值 | 選填。僅支援 false。 |
以一張參考照片生成一系列圖片
將範例網址替換為可公開存取的產品照片網址。此範例會生成 3 張連貫圖片。請在同一段提示詞中寫出每個畫面的指示。
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}取得所有圖片
將 POST 回應中的 id 複製到 TASK_ID。使用相同的金鑰輪詢此端點,直到任務狀態為 completed 或 failed。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"任務完成後,讀取 output.data[].url 中的所有網址。單一任務可能會回傳多張圖片。如果狀態檢查中斷,請再次查詢原始 ID。請參閱任務參考,了解任務生命週期;錯誤代碼請參閱錯誤目錄。
價格
總費用為所要求解析度的輸出圖片張數乘以即時輸出費率,再加上每張輸入參考圖片的費用。生成 4 張 4K 圖片並使用 2 張參考圖片,費用為 4 筆 4K 輸出費用加上 2 筆參考圖片費用。請求失敗不會收費。請參閱目前費率。
錯誤與提示
輸入無效時會回傳請求錯誤。請檢查是否缺少提示詞文字、參考圖片 ID 重複,或使用不支援的解析度或 series 設定。如果初次呼叫已回傳任務 ID,請先查詢該 ID,再判斷是否需要重新提交。
若描述中包含多張參考圖片,請為每個主體指定不同名稱,並告訴模型每張參考圖片要提供哪些視覺特徵。請在提示詞中說明鏡頭指示與鏡頭順序。請參閱 Kling Image 4.0 playground 與 OpenAPI 結構描述。
