APIMaster.ai

Kling Image 4.0 · 圖片 API

用 Kling Image 4.0 生成單圖、連貫組圖、電商詳情頁和網頁設計長圖。

Kling Image 4.0

用 Kling Image 4.0 生成單圖、連貫組圖、電商詳情頁和網頁設計長圖。

端點

  • POST https://apimaster.ai/v1/kling/kling-image-4.0/image-generation · single, series
  • POST https://apimaster.ai/v1/kling/kling-image-4.0/long-image-generation · ecommerce, webpage
  • GET https://apimaster.ai/v1/kling/kling-image-4.0/tasks/{task_id}

請求參數

欄位 取值
contents JSON · type → prompt, refer_image, element, style_refer_image, subject_refer_image.
contents[].text 必須提供一項非空提示詞。用 @id 在提示詞中引用對應素材。
contents[].id 每個參考素材在本次請求內的唯一識別碼。
contents[].url 公開圖片 URL 或 Base64。支援 JPG、JPEG、PNG,單張不超過 30 MB,寬高均至少 300 像素,比例為 2:5 至 5:2。
contents[].element_id 本帳號擁有的圖片主體代碼或支援的預設代碼。每個主體按一項參考素材計。
settings.result_type single, series. 預設 single.
settings.n single → 1–9. 預設 1.
settings.series_amount series → 2–10 / auto (2–10). 預設 4.
settings.resolution single / series → 2k, 4k, 8k. 預設 2k. ecommerce / webpage → 1k, 2k. 預設 1k.
settings.aspect_ratio single / series → auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. 預設 auto.
settings.skill long-image-generation → ecommerce, webpage.
settings.length ecommerce → short, medium, long. 預設 medium.
options.watermark_info.enabled boolean. 預設 false. true → outputs[].watermark_url.
options.callback_url 選填回呼網址,須先在本 APIMaster 帳號下註冊並驗證。
options.external_task_id 選填業務關聯 ID,最多 128 位元組,隨任務回傳。

普通圖和組圖的參考圖與主體合計最多 10 項。電商需 1–3 項 refer_image。網頁最多支援一項風格圖與一項主體圖。

普通圖支援純英文 50,000 字元或純非英文 21,000 字元。長圖分別為 166,000 和 71,000。混合輸入時,兩類字元數各除以上限,合計不得超過 1。

單圖模式生成獨立圖片。組圖模式依組內順序回傳連貫圖片,同組共用 group_id。 長圖每次回傳一張完整圖片。length 只適用於電商,分別約 2–5、6–10 或 11–18 個內容區塊。

呼叫範例

single

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/image-generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling-image-example-001" \
  -d '{"contents":[{"type":"prompt","text":"A blue ceramic cup in soft daylight"}],"settings":{"resolution":"2k","aspect_ratio":"1:1"}}'

series

{
  "contents": [
    {
      "type": "prompt",
      "text": "Create two coordinated studio photographs of the blue ceramic cup in @cup. Show a front view and a detail close-up."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "result_type": "series",
    "series_amount": 2,
    "resolution": "4k",
    "aspect_ratio": "3:4"
  },
  "options": {
    "watermark_info": {
      "enabled": true
    },
    "external_task_id": "campaign-cup-001"
  }
}

ecommerce

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a product detail page for @cup. Include a hero image, material details, and care instructions."
    },
    {
      "type": "refer_image",
      "id": "cup",
      "url": "https://example.com/cup.png"
    }
  ],
  "settings": {
    "skill": "ecommerce",
    "length": "short",
    "resolution": "1k"
  }
}

webpage

{
  "contents": [
    {
      "type": "prompt",
      "text": "Design a long product landing page for a ceramic cup collection."
    }
  ],
  "settings": {
    "skill": "webpage",
    "resolution": "2k"
  }
}

任務結果

儲存 task_id 並用同一帳號查詢。成功時 outputs 回傳各圖的 URL,以及選填的 watermark_url 和 group_id。失敗時讀取 error。

curl -sS "https://apimaster.ai/v1/kling/kling-image-4.0/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "task_id": "task_example",
  "object": "image",
  "model": "kling-image-4.0",
  "status": "completed",
  "outputs": [{"type": "image", "url": "https://example.com/generated.png"}]
}

重試同一請求時沿用 Idempotency-Key。逾時後查詢原任務。

計費

費用為交付張數乘輸出單價,加參考素材數乘輸入單價。客戶即時價格見模型廣場。 Kling Image 4.0