Kling Multi-Image Subject Generation

Channel type: Kling Extended (66) Gateway path: POST https://maasunion.com/kling/v1/extended/general/ai-multi-shot · GET .../ai-multi-shot/{task_id} Official upstream: https://api-beijing.klingai.com (/v1/general/ai-multi-shot)

Overview

The multi-image subject generation capability is based on a single frontal reference image, generating multi-view images of that subject (front, side, back, etc.), commonly used to expand subject library materials.

Authentication

Header	Required	Description
`Authorization`	Yes	`Bearer {your_api_token}`
`Content-Type`	Required for POST	`application/json`

Create Task

POST https://maasunion.com/kling/v1/extended/general/ai-multi-shot

Request Parameters

Parameter	Type	Required	Description
`element_frontal_image`	string	Yes	Frontal reference image URL
`external_task_id`	string	No	Custom task ID
`callback_url`	string	No	Callback URL

Request Example

curl --request POST \
  --url "https://maasunion.com/kling/v1/extended/general/ai-multi-shot" \
  --header "Authorization: Bearer {your_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "element_frontal_image": "https://example.com/frontal.png"
  }'

Create Response

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "submitted",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

Query Task

GET https://maasunion.com/kling/v1/extended/general/ai-multi-shot/{task_id}

curl --request GET \
  --url "https://maasunion.com/kling/v1/extended/general/ai-multi-shot/{task_id}" \
  --header "Authorization: Bearer {your_api_token}"

The query response contains multi-view URLs in task_result.images:

{
  "code": 0,
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "succeed",
    "task_result": {
      "images": [
        { "url_1": "string", "url_2": "string", "url_3": "string" }
      ]
    },
    "final_unit_deduction": "string"
  }
}

Field	Description
`task_result.images[].url_1` / `url_2` / `url_3`	Multi-view image URLs

Task Status

`task_status`	Meaning
`submitted`	Submitted
`processing`	Processing
`succeed`	Succeeded
`failed`	Failed

For more general information, see Kling Gateway Overview.