Skip to main content
POST
Create Video Generation

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08

Body

application/json
model
string
required
content
VideoContentItem · object[]
required
previous_task_id
string | null
callback_url
string | null
return_last_frame
boolean
default:false
service_tier
string | null
execution_expires_after
integer | null
generate_audio
boolean | null
draft
boolean | null
resolution
string | null
ratio
string | null
duration
integer | null
fast_pretreatment
boolean | null
frames
integer | null
seed
integer | null
camera_fixed
boolean | null
watermark
boolean | null
safety_identifier
string | null
priority
integer | null
Required range: 0 <= x <= 9

Response

Task created; poll the returned id for status

id
string
required
model
string | null
status
string
default:queued
error
VideoTaskError · object | null
created_at
integer | null
updated_at
integer | null
content
VideoTaskContent · object | null
seed
integer | null
resolution
string | null
ratio
string | null
duration
integer | null
frames
integer | null
framespersecond
integer | null
generate_audio
boolean | null
safety_identifier
string | null
priority
integer | null
draft
boolean | null
draft_task_id
string | null
service_tier
string | null
execution_expires_after
integer | null
usage
VideoTaskUsage · object | null