Skip to main content
POST
cURL (submit, poll, download)

Authorizations

Authorization
string
header
required

The workspace API key (pdk_…) from Integrations → Built-in in the pre.dev dashboard.

Headers

x-predev-project-id
string

Attribute this call to one of the workspace's projects. An id the workspace does not own is ignored.

Body

application/json
model
string
required

An id from GET /v1/videos/models.

Example:

"bytedance/seedance-2.0-mini"

prompt
string

What to generate. Optional for models that work from images alone.

duration
integer

Seconds. See the model row's supported_durations.

resolution
string
Examples:

"480p"

"720p"

"1080p"

aspect_ratio
string
Examples:

"16:9"

"9:16"

"1:1"

size
string

Exact pixels, such as 1280x720.

frame_images
object[]

First or last frame images, on models that list supported_frame_images.

input_references
(string | object)[]

Reference images, audio or video, on models that accept them. An image can be a URL or data: URL string.

A URL or data: URL of a reference image.

generate_audio
boolean
seed
integer

Response

The job was accepted.

id
string
required

Job id. Poll GET /v1/videos/{id} and download from GET /v1/videos/{id}/content.

polling_url
string<uri>
required

https://api.pre.dev/v1/videos/{id} for this job: the status URL, ending with the job's id.

status
enum<string>
required
Available options:
pending,
in_progress,
completed,
failed,
cancelled,
expired
generation_id
string
unsigned_urls
string[]

Present when the job has completed. Download through GET /v1/videos/{jobId}/content.

error
string

Why the job failed.