---
title: "Multi-Image to Image"
method: POST
path: "/kling/v1/images/generations"
---

# Multi-Image to Image

`POST /kling/v1/images/generations`

## Headers

- `Content-Type` string

## Request body

- object — Kling Image Generation API request body definition
  - `model_name` 'kling-v2' — Model to use for multi-image generation.
  - `prompt` string — Text prompt describing the desired output. Max 2500 characters.
  - `subject_image_list` object[], required — List of subject reference images. Minimum 2, maximum 4.
    - `subject_image` string, required — Image URL or raw Base64 string (no `data:` prefix). Supported formats: JPG, JPEG, PNG. Max 10 MB, minimum 300 px per side, aspect ratio between 1:2.5 and 2.5:1.
  - `scence_image` string — Optional scene reference image. Same format and size constraints as subject images.
  - `style_image` string — Optional style reference image. Same format and size constraints as subject images.
  - `n` integer — Number of images to generate.
  - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' — Aspect ratio of the generated image (width:height).
  - `callback_url` string — Webhook URL for task status notifications. The server sends a callback when the task status changes.
  - `external_task_id` string — Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

## Response `200`

Successful Response

- object
  - `code` integer — Error code; specifically define the error code
  - `message` string — error message
  - `request_id` string — Request ID, system-generated, for tracking requests, troubleshooting issues
  - `data` object
    - `task_id` string, required — Task ID, system generated
    - `task_status` string, required — Task status, enumerated values: submitted, processing, succeed, failed.
    - `created_at` integer, required — Task creation time, Unix timestamp, in ms.
    - `updated_at` integer, required — Task update time, Unix timestamp, in ms.

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/versions/b6265ced74a1/schema)