Kling Standard Image (Generation/Editing)

Channel type: Kling Image (64) Gateway path: POST/GET https://maasunion.com/kling/v1/standard/images/... Official upstream: https://api-beijing.klingai.com (/v1/images/generations, /v1/images/multi-image2image, /v1/images/editing)

Overview

The standard image endpoints cover Kling's traditional image models, supporting text-to-image, image-to-image, multi-image reference image generation, and image editing. Models are distinguished by model_name.

For the Omni image model, use the Omni Image endpoint.

Supported Models

model_name	Description
`kling-v3`	Kling Image 3.0
`kling-v2-1`	Kling Image 2.1
`kling-v2-new`	Kling Image 2.0 New
`kling-v2`	Kling Image 2.0
`kling-v1-5`	Kling Image 1.5
`kling-v1`	Kling Image 1.0

Interface Overview

Method	Gateway path	Official upstream	Description
POST	`/kling/v1/standard/images/generations`	`/v1/images/generations`	Text-to-image / single-image image-to-image
GET	`/kling/v1/standard/images/generations/{task_id}`	`/v1/images/generations/{id}`	Query
POST	`/kling/v1/standard/images/multi-image2image`	`/v1/images/multi-image2image`	Multi-image reference image generation
GET	`/kling/v1/standard/images/multi-image2image/{task_id}`	`/v1/images/multi-image2image/{id}`	Query
POST	`/kling/v1/standard/images/editing`	`/v1/images/editing`	Image editing
GET	`/kling/v1/standard/images/editing/{task_id}`	`/v1/images/editing/{id}`	Query
POST	`/kling/v1/standard/images/image2image`	Compatibility alias	Single image goes to `generations`; multiple images go to `multi-image2image`

image2image compatibility note: /v1/images/image2image does not exist in the official Kling API. The gateway provides this path as a compatibility alias: a request body with the image field goes to generations, and multiple reference images go to multi-image2image.

Authentication

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

Text-to-Image / Image-to-Image

POST https://maasunion.com/kling/v1/standard/images/generations

Request Parameters

Parameter	Type	Required	Description
`model_name`	string	Yes	Model name
`prompt`	string	Yes	Positive prompt, up to 2500 characters
`negative_prompt`	string	No	Negative prompt (not supported for image-to-image)
`image`	string	No	Reference image URL or Base64. Not passing means text-to-image; passing means image-to-image
`n`	int	No	Number of images to generate
`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/standard/images/generations" \
  --header "Authorization: Bearer {your_api_token}" \
  --header "Content-Type: application/json" \
  --data '{
    "model_name": "kling-v2-1",
    "prompt": "生成皮克斯风格的小狗",
    "negative_prompt": "",
    "n": 2
  }'

Multi-Image Reference Image Generation

POST https://maasunion.com/kling/v1/standard/images/multi-image2image

Generates an image based on multiple reference images (subjects, scenes, style). The request body follows the official Kling /v1/images/multi-image2image structure and is passed through as-is.

Image Editing

POST https://maasunion.com/kling/v1/standard/images/editing

Edits the passed-in image. The request body follows the official Kling /v1/images/editing structure and is passed through as-is.

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
  }
}

Field	Description
`data.task_id`	Gateway task ID, used for subsequent queries
`data.task_status`	`submitted` / `processing` / `succeed` / `failed`

Query Task

GET https://maasunion.com/kling/v1/standard/images/generations/{task_id} GET https://maasunion.com/kling/v1/standard/images/multi-image2image/{task_id} GET https://maasunion.com/kling/v1/standard/images/editing/{task_id}

curl --request GET \
  --url "https://maasunion.com/kling/v1/standard/images/generations/{task_id}" \
  --header "Authorization: Bearer {your_api_token}"

Query Response

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "gateway_public_task_id",
    "task_status": "succeed",
    "task_status_msg": "string",
    "final_unit_deduction": "string",
    "watermark_info": { "enabled": false },
    "task_info": { "external_task_id": "string" },
    "created_at": 1722769557708,
    "updated_at": 1722769557708,
    "task_result": {
      "images": [
        { "index": 0, "url": "string", "watermark_url": "string" }
      ]
    }
  }
}

Field	Description
`data.task_status`	`submitted` / `processing` / `succeed` / `failed`
`data.task_result.images[].url`	Image download URL (valid for about 30 days; please persist in time)
`data.task_result.images[].watermark_url`	Watermarked image URL
`data.final_unit_deduction`	Number of credits deducted by the upstream

Task Status

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

For more general information, see Kling Gateway Overview.