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 空でないプロンプトを 1 件指定します。個別の素材は @id で参照できます。
contents[].id リクエスト内で一意の参照 ID です。
contents[].url 公開画像 URL または Base64。JPG、JPEG、PNG、各 30 MB 以下。両辺 300 px 以上、縦横比 2:5〜5:2。
contents[].element_id 自分のアカウントの画像エレメント、または対応プリセットの識別子。参照 1 件として数えます。
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 任意の Webhook URL。APIMaster アカウントに登録し、事前に検証してください。
options.external_task_id 任意の関連付け ID。128 バイトまでで、タスクとともに返ります。

通常画像とシリーズは画像とエレメントを合計 10 件まで使用できます。商品詳細は refer_image が 1〜3 件必須。ウェブページはスタイルと被写体の参照を各 1 件まで指定できます。

通常画像のプロンプトは英語のみで 50,000 文字、非英語のみで 21,000 文字まで。縦長画像はそれぞれ 166,000、71,000 文字まで。混在時は各上限に対する割合の合計が 1 以下です。

単体モードでは独立した画像を生成します。シリーズは順番に返り、同じ group_id を共有します。 縦長画像は毎回 1 枚です。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