curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-image-o1",
"input": {
"prompt": "Use image 1 as the flooded forest boardwalk scene to edit and image 2 only as the animal identity reference. Edit the scene in image 1 by adding exactly one adult Malayan tapir, the tapir from image 2, standing on the wide wooden deck in the left-center foreground. Preserve the exact tapir identity and anatomy from image 2: black head, neck and hindquarters, broad white saddle, short flexible snout and white-rimmed ears. The tapir faces left in three-quarter side view, pausing as if listening toward the flooded forest. Its full body must be visible, four feet planted naturally on the boardwalk, correct real-world scale, weight and soft contact shadows. Preserve the boardwalk structure, tree positions, floodwater reflections, original camera perspective and documentary photographic style. Match the soft green canopy daylight. Do not add people, other animals, accessories, text, logos or watermark.",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-02.png"
],
"resolution": "2K",
"size": "16:9",
"output_format": "png",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "G9UB0VC3IRIBRX9W",
"status": "running",
"created_time": "2026-09-24T11:52:39"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Kling
Kling O1 Image Edit
Edit images with Kling O1 using visual references and subject elements, with batch output and resolutions up to 2K.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-image-o1",
"input": {
"prompt": "Use image 1 as the flooded forest boardwalk scene to edit and image 2 only as the animal identity reference. Edit the scene in image 1 by adding exactly one adult Malayan tapir, the tapir from image 2, standing on the wide wooden deck in the left-center foreground. Preserve the exact tapir identity and anatomy from image 2: black head, neck and hindquarters, broad white saddle, short flexible snout and white-rimmed ears. The tapir faces left in three-quarter side view, pausing as if listening toward the flooded forest. Its full body must be visible, four feet planted naturally on the boardwalk, correct real-world scale, weight and soft contact shadows. Preserve the boardwalk structure, tree positions, floodwater reflections, original camera perspective and documentary photographic style. Match the soft green canopy daylight. Do not add people, other animals, accessories, text, logos or watermark.",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-02.png"
],
"resolution": "2K",
"size": "16:9",
"output_format": "png",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "G9UB0VC3IRIBRX9W",
"status": "running",
"created_time": "2026-09-24T11:52:39"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- kwaivgi/kling-image-o1 - Edit images using a prompt and image references.
Features
- Edit images using a prompt and image references.
- Accepts 1-10 images in
image_urls. - Choose from
1K,2Koutput resolutions. - Supply additional subject references through
elements. - Control the number of output images with
n.
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 from1to9. Default:1.
Output Format
output_format: Optional. Accepted values:jpeg,png,webp. Default:png.
Advanced Parameters
Setmodel 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. -
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
{
"model": "kwaivgi/kling-image-o1",
"input": {
"prompt": "Use image 1 as the flooded forest boardwalk scene to edit and image 2 only as the animal identity reference. Edit the scene in image 1 by adding exactly one adult Malayan tapir, the tapir from image 2, standing on the wide wooden deck in the left-center foreground. Preserve the exact tapir identity and anatomy from image 2: black head, neck and hindquarters, broad white saddle, short flexible snout and white-rimmed ears. The tapir faces left in three-quarter side view, pausing as if listening toward the flooded forest. Its full body must be visible, four feet planted naturally on the boardwalk, correct real-world scale, weight and soft contact shadows. Preserve the boardwalk structure, tree positions, floodwater reflections, original camera perspective and documentary photographic style. Match the soft green canopy daylight. Do not add people, other animals, accessories, text, logos or watermark.",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-01.png",
"https://cdn.vidgo.ai/apis/models/kwaivgi/kling-image-o1/edit/v1/01/input-02.png"
],
"resolution": "2K",
"size": "16:9",
"output_format": "png",
"n": 1
}
}
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
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.
Example:
"kwaivgi/kling-image-o1"
Input parameters for image editing
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.