Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Kling O1 Image Edit

Edit images with Kling O1 using visual references and subject elements, with batch output and resolutions up to 2K.

Available Models

  • kwaivgi/kling-image-o1 - Edit images using a prompt and image references.

Output Options

Image Size

  • size: Optional. Accepted values: auto, 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9. Default: auto.

Resolution

  • resolution: Optional. Accepted values: 1K, 2K. Default: 1K.

Image Count

  • n: Optional. Number of images to generate. Integer from 1 to 9. Default: 1.

Output Format

  • output_format: Optional. Accepted values: jpeg, png, webp. Default: png.

Key Features

  • Edit images using a prompt and image references.
  • Accepts 1-10 images in image_urls.
  • Choose from 1K, 2K output resolutions.
  • Supply additional subject references through elements.
  • Control the number of output images with n.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

Prompt

  • prompt: Required. Describe the desired image. Length: 1-2,000 characters.
  • The value must not be blank when supplied.

Image URLs

  • image_urls: Required. Provide publicly accessible image URLs. Supply 1-10 items. Each item must be an HTTP(S) URL. A single URL string and Base64 inputs are not accepted.

Subject Elements

  • elements: Optional array of subject-reference objects. Refer to them in the prompt as @Element1, @Element2, etc., in array order. Additional object properties are preserved. No element or additional-view count limit is specified by the upstream contract.
  • elements[].frontal_image_url: Optional. Use a publicly accessible HTTP(S) URL.
  • elements[].reference_image_urls: Optional. Supply an array. Each item must be an HTTP(S) URL.

Tested multi-image example

Billing Factors

Billing depends on output image count (n). Both supported resolutions use the same rate. Reference images and subject elements do not add charges. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.

model
string
required
Example:

"kwaivgi/kling-image-o1"

input
object
required

Input parameters for image editing

callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required