> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling O3 Image Edit > Rework images with Kling O3 using multiple references and subject elements, with output up to 4K and support for visual variations. 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](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Kling O3 Image Edit Rework images with Kling O3 using multiple references and subject elements, with output up to 4K and support for visual variations. ## Available Models * **kwaivgi/kling-image-o3/edit** - 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: `16:9`. ### Resolution * `resolution`: Optional. Accepted values: `1K`, `2K`, `4K`. Default: `1K`. ### Image Count * `n`: Optional. Number of images to generate. Integer from `1` to `9`. Default: `1`. Fractional values, strings, and booleans are rejected. ### 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`, `4K` output resolutions. * Supply additional subject references through `elements`. * Control the number of output images with `n`. ## Advanced Parameters Defaults apply only when an optional input field is omitted. Explicit `null` or empty-string values are rejected. An empty `elements` array is accepted. 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 requested changes. 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. ### Subject Elements * `elements`: Optional. Provide subject-reference objects. Supply an array. Each item is an object. * `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. Refer to subjects in the prompt as `@Element1`, `@Element2`, etc. Element objects may include additional fields; no element count limit is specified. ## Billing Factors Billing depends on output resolution (`resolution`) and output image count (`n`). Text-to-image and image editing use the same rates. Reference images and subject elements do not add charges. Credits are deducted on submission and refunded if the task fails. ## OpenAPI ````yaml api-manual/image-series/kwaivgi-kling-image-o3-edit.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Kling O3 Image Edit description: >- Rework images with Kling O3 using multiple references and subject elements, with output up to 4K and support for visual variations. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Kling O3 Image Edit description: >- Send only the fields shown for this workflow. Parameters from other workflows are rejected before credits are deducted. When supplied, prompt must not be blank. Input URL fields require HTTP(S) URLs with a hostname and no embedded credentials. operationId: submit_kwaivgi_kling_image_o3_edit requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: kwaivgi/kling-image-o3/edit input: type: object required: - image_urls - prompt properties: prompt: type: string description: Generation prompt describing the desired output maxLength: 2000 example: >- A cinematic futuristic alley with rain and neon reflections minLength: 1 image_urls: type: array items: type: string format: uri minItems: 1 maxItems: 10 description: >- Reference image URLs. Required for image editing. Provide 1-10 publicly accessible HTTP(S) URLs. example: - https://example.com/reference1.png elements: type: array description: >- Optional array of element descriptors for character/object control. Reference them in prompt as @Element1, @Element2, etc. Recommended fields are `frontal_image_url` and optional `reference_image_urls`. items: type: object properties: frontal_image_url: type: string format: uri description: >- Public image URL for the main face/object reference. reference_image_urls: type: array description: >- Optional additional public image URLs for the same element. items: type: string format: uri additionalProperties: true example: - frontal_image_url: https://example.com/lead-model-front.png reference_image_urls: - https://example.com/lead-model-side.png resolution: type: string description: Output resolution preset enum: - 1K - 2K - 4K default: 1K example: 4K size: type: string description: >- Output aspect ratio preset. Supports fixed aspect ratios and `auto`. enum: - auto - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' - '3:2' - '2:3' - '21:9' default: '16:9' example: '16:9' output_format: type: string description: Output image format. enum: - jpeg - png - webp default: png example: png 'n': type: integer description: >- Number of images to generate (1-9). Billing is based on the selected resolution and `n`. minimum: 1 maximum: 9 default: 1 example: 2 additionalProperties: false description: Input parameters for image generation or editing callback_url: type: string nullable: true description: >- Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks. description: >- Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected. examples: basic: summary: Basic workflow value: model: kwaivgi/kling-image-o3/edit input: image_urls: - https://example.com/image.png prompt: >- A quiet forest under soft morning light, with natural detail. resolution: 1K size: '16:9' output_format: png 'n': 1 callback: summary: Receive a completion callback value: model: kwaivgi/kling-image-o3/edit input: image_urls: - https://example.com/image.png prompt: >- A quiet forest under soft morning light, with natural detail. resolution: 1K size: '16:9' output_format: png 'n': 1 callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: >- Invalid input, unsupported tier, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Unable to create the generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````