---
title: "Generate a Kling image from multiple images"
method: POST
path: "/kling/v1/images/multi-image2image"
---

# Generate a Kling image from multiple images

`POST /kling/v1/images/multi-image2image`

## Headers

- `Content-Type` string

## Request body

- object
  - `model_name` 'kling-v2' | 'kling-v2-1' — Model to use for multi-image generation. Use `kling-v2-1` for new requests; omitting the field uses the legacy route default.
  - `prompt` string — Text prompt describing the desired output. Maximum 2500 characters.
  - `negative_prompt` string — Elements to exclude from the image. Maximum 2500 characters.
  - `subject_image_list` object[], required — Subject reference images. Minimum 1, maximum 4.
    - `subject_image` string, required — Image URL or raw Base64 string without a `data:` prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
  - `scene_image` string — Optional scene reference image. Image URL or raw Base64 string without a `data:` prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
  - `style_image` string — Optional style reference image. Image URL or raw Base64 string without a `data:` prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
  - `n` integer — Number of images to generate. Range: 1-9.
  - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' — Aspect ratio of the generated image.
  - `watermark_info` object — Watermark options.
    - `enabled` boolean
  - `callback_url` string — Webhook URL for task status notifications.
  - `external_task_id` string — Optional user-defined task ID for your own tracking. Must be unique per account.

## Response `200`

Task request accepted or an error response returned by the API.

- object
  - `code` union, required — Response code. `0` means the task request was accepted.
    - integer
    - string
  - `message` string, required — Response message.
  - `request_id` string — Request identifier returned when present.
  - `data` object, required
    - `task_id` string, required — System-generated task ID.
    - `task_status` 'submitted' | 'processing' | 'succeed' | 'failed', required — Task status.
    - `task_status_msg` string, nullable — Task status detail when present.
    - `task_info` object
      - `external_task_id` string, nullable — Caller-provided external task ID when supplied.
    - `task_result` object, nullable — Task result payload after the task completes.
    - `created_at` integer, required — Task creation time as a Unix timestamp in milliseconds.
    - `updated_at` integer, required — Task update time as a Unix timestamp in milliseconds.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)