Skip to main content
POST
/
videos
Create a video generation job
curl --request POST \
  --url https://api.budgetpixel.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-1.5-pro",
  "prompt": "a calm ocean wave rolling onto a sandy beach, cinematic",
  "aspect_ratio": "16:9",
  "length_seconds": 5,
  "negative_prompt": "<string>",
  "resolution": "<string>",
  "seed": 123
}
'
{
  "credits_to_charge": 300,
  "estimated_time": "3 minutes",
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "message": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
​
model
string
required

A model where type=video from GET /v1/models.

Example:

"seedance-1.5-pro"

​
prompt
string
required
Example:

"a calm ocean wave rolling onto a sandy beach, cinematic"

​
aspect_ratio
enum<string>
Available options:
1:1,
16:9,
9:16,
4:3,
3:4,
21:9,
3:2,
2:3
Example:

"16:9"

​
length_seconds
integer
default:5
Example:

5

​
negative_prompt
string
​
resolution
string

Model-dependent (e.g. 480p, 720p, 1080p).

​
seed
integer

Response

Job accepted.

​
credits_to_charge
integer

Quoted credit cost; charged on success.

Example:

300

​
estimated_time
string
Example:

"3 minutes"

​
job_id
string<uuid>
​
message
string
​
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout