Skip to main content
POST
cURL

Usage notes

  • Source video: pass exactly one MP4/MOV video (3-15.5 seconds) in video_urls, plus up to 4 optional reference images. Output duration and aspect ratio follow the source video, so duration and aspect_ratio are not accepted. Set keep_original_sound to true to keep the original audio.
  • Referencing inputs: images are numbered image_1..image_N in order and the video is video_1. Use @image_1 / @video_1 in the prompt to point at a specific input.
  • Not supported: negative_prompt (write exclusions into the prompt), audio_urls, and video_url (use video_urls).

Billing

Billed per second of the source video duration (rounded up to whole seconds), using the enhanced tier for 720p/1080p (or the 4K tier). The per-second rate depends on the tier: 720p basic, 720p enhanced, 1080p basic, 1080p enhanced, or 4K. The enhanced tier applies when native audio is enabled or any video input is provided. Current prices are shown on the model page.

Task flow

The create call returns data.task_id. Poll Query video task until status is completed (outputs in data.result) or failed, or pass callback_url to be notified when the task reaches a terminal state.

Authorizations

Authorization
string
header
required

Use your APIPod API key as a Bearer token in the Authorization header.

Body

application/json
model
string
required

Public APIPod model ID.

Allowed value: "kling-3.0-omni-edit"
prompt
string
required

Required editing instruction, up to 2,500 characters. Inputs are numbered automatically: images become image_1..image_N in order and the video becomes video_1; reference them in the prompt as @image_1 or @video_1.

Maximum string length: 2500
video_urls
string[]
required

Exactly one source video URL to edit (MP4 or MOV, 3-15.5 seconds). The output duration and aspect ratio follow this video.

Required array length: 1 element
image_urls
string[]

Optional reference image URLs (up to 4).

Maximum array length: 4
resolution
enum<string>
default:720p

Output resolution. Defaults to 720p. The per-second rate depends on the resolution tier.

Available options:
720p,
1080p,
4k
keep_original_sound
boolean
default:false

Keep the audio track of the source video. Defaults to false (the output has no original audio).

watermark
boolean
default:false

When true, an additional watermarked copy is generated and the watermarked copy is returned as the result.

callback_url
string
default:""

HTTPS URL that receives the task's terminal state.

Response

200 - application/json

Task accepted

Standard response for task submission

code
integer
required
data
Task Submit Data · object
required

Data content for task submission

message
string
required