Sign in
Videos

Edit a video into a new job

POST /v1/videos/edits

post/api/v1/videos/edits

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/videos/edits
  • Auth: HTTP bearer

Request body

promptstring required

Instructions describing the edit.

Response

New video job

completed_atinteger nullable

Unix timestamp (seconds) when the job completed.

created_atinteger required

Unix timestamp (seconds) when the job was created.

expires_atinteger nullable

Unix timestamp (seconds) when the rendered asset expires.

idstring required

Unique job identifier.

modelstring required

Model used for generation.

objectstring

Object type, always "video".

progressinteger nullable

Approximate completion percentage (0-100).

promptstring nullable

Original generation prompt.

remixed_from_video_idstring nullable

Source video id when this job is a remix.

secondsstring nullable

Requested duration in seconds.

sizestring nullable

Output resolution.

status'queued' | 'in_progress' | 'completed' | 'failed' required

Status of a video generation job.

Changes

No recorded changes to this operation across all 1 revision of this API.