Skip to main content
POST
Edit a finished video

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Path Parameters

id
string
required

Body

application/json
scenes
object[]

Scene templates (ai_videographer, remotion, freeform_ai, site_demo): edits by scene id. Scenes you leave out keep what they have.

Required array length: 1 - 30 elements
script
string

A template that speaks one script (talking_avatar, phone_mockup, a narrated real_footage): the whole new script, spoken again

Required string length: 1 - 6000
sections
string[]

A scrolling background: one text per section, in order

Required array length: 1 - 10 elements
Maximum string length: 1500
on_screen_caption
string

real_footage: the caption over the clip, or several separated by a blank line

Required string length: 1 - 454
voice_id
string

A new narrator, as for voice_id on POST /v1/videos. Everything spoken is said again.

Required string length: 1 - 100
voice_model
string | null

With an ElevenLabs narrator: the speech model

Maximum string length: 100
subtitle_style
enum<string>

Burned-in captions in another style, or none to take them off. A captions-only edit is free.

Available options:
none,
classic,
boxed,
bold_words,
dynamic,
dynamic_highlight,
emphasis,
enlarge,
one_word,
comic,
highlight
subtitle_emojis
boolean
subtitle_highlight_color
string | null

The accent colour of the highlighting caption styles, as #rrggbb; null is the default

Pattern: ^#[0-9a-fA-F]{6}$
max_price_cents
integer

A spending cap: an edit priced above it is refused with 400 and nothing changes

Required range: 0 <= x <= 9007199254740991

Response

Success

data
object
required