Claude Opus 5.5 已在 SeedRouter 上線

Image

Kling Image 4.0

View Markdown

使用 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 結構描述。