Skip to main content

VideoCreateIn

qualityQuality

standard, or pro for reference media, up to 15 seconds and 4k resolution. Defaults to standard.

Possible values: [standard, pro]

Default value: standard
promptPromptrequired

What happens in the video.

Possible values: non-empty and <= 4000 characters

first_framestring<uuid>nullable

An image (file id) the video starts from.

last_framestring<uuid>nullable

An image (file id) the video ends on. Requires first_frame.

reference_imagesstring<uuid>[]nullable

pro only: up to 9 images (file ids) whose subjects or look the video follows. Not together with first_frame / last_frame.

Possible values: <= 9

reference_videosstring<uuid>[]nullable

pro only: up to 3 videos (file ids), 15 seconds together at most, whose motion or camera work the video follows.

Possible values: <= 3

reference_audiosstring<uuid>[]nullable

pro only: up to 3 audio clips (file ids) for the video's sound. Needs at least one reference image or video.

Possible values: <= 3

durationDuration

Length in seconds: 4–12 (pro: up to 15). Defaults to 5.

Possible values: >= 4 and <= 15

Default value: 5
aspect_ratioAspect Ratio

The frame's shape; auto follows the inputs. Defaults to auto.

Possible values: [16:9, 4:3, 1:1, 3:4, 9:16, 21:9, auto]

Default value: auto
resolutionResolution

480p, 720p or 1080p (pro: also 4k). Defaults to 720p.

Possible values: [480p, 720p, 1080p, 4k]

Default value: 720p
audioAudio

Give the video sound. Defaults to true.

Default value: true
VideoCreateIn
{
"prompt": "A paper boat drifting down a rainy street, the camera following it"
}