Skip to main content
POST
Generate video with Kling V3 Omni

Kling V3 Omni on BudgetPixel

More examples, prompts and pricing.

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the video, or the change to make when editing a video (up to 2,500 characters). Reference images may be named in the prompt as <<<image_1>>>, <<<image_2>>>, ... in the order sent, and the video to edit as <<<video_1>>>. Write @handle to cast a character: a BudgetPixel AI influencer or one of your own (GET /v1/characters).

aspect_ratio
enum<string>
default:16:9

Aspect ratio. Ignored when an input image or video already sets the frame.

Available options:
16:9,
9:16,
1:1
end_image
string

Optional end frame, used together with image (the start frame) to interpolate the video between the two frames. Same input forms as image.

generate_audio
boolean

Generate audio with the video. Raises the 720p/1080p per-second rate (no price impact at 4K); unavailable on video-edit.

image
string

Optional start frame for image-to-video. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. JPG or PNG, at least 300px on each side, aspect ratio between 2:5 and 5:2. Omit for text-to-video. Can't be combined with reference_images.

length_seconds
integer
default:5

Video length in seconds (3–15). Ignored when editing a video (the output keeps its length).

Required range: 3 <= x <= 15
reference_images
string[]

Optional reference images that guide the generated video. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image (start/end frames). Up to 7 on their own (reference-images-to-video); up to 4 when accompanying a video edit.

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

Output resolution: 720p (standard), 1080p (pro) or 4k. Pricing varies by resolution — see resolution_pricing in GET /v1/models.

Available options:
720p,
1080p,
4k
video
string

Optional video to EDIT (MP4 or MOV, 3-10 seconds, 720-2160 pixels on each side, up to 100MB). Provide a public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined). The request then runs in video-edit mode: up to 4 reference_images may guide the edit, start/end frames are not supported, the clip keeps its own sound and no audio is generated, and the output keeps the clip's length and shape, so length_seconds, aspect_ratio and generate_audio are ignored. Billed per second of output at the edit rate, for the clip's length rounded up to a whole second (measured by us). 720p or 1080p only: 4K can't edit a video.

Response

Job accepted.

characters
object[]

The characters the prompt cast with @handle mentions. Absent when none.

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout