Skip to main content
POST
/
videos
/
generations
Submit a video generation request
curl --request POST \
  --url https://api.maxai.lol/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": 7,
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "input": {
    "positivePrompt": "<string>",
    "frameImage": "<string>"
  },
  "model": "<string>",
  "seed": 4611686018427388000,
  "dimensions": {
    "width": 1232,
    "height": 1232
  }
}
'
{
  "status": 200,
  "data": {
    "requestId": "42ebbfe9-80ba-4702-8532-8c73813bd0a8"
  }
}

​
Video Generation is a Beta Feature

Only the Seedance 1.0 Pro Fast model is supported for video generation. Because this model is exclusively accessible through approved API providers, the safetyLevel parameter is automatically enforced at high and may be omitted in all requests.Video generation does not yet support NSFW scanning. The safetyLevel parameter is currently ignored and results.[].isNSFW will always return null. We plan to introduce full NSFW scanning support in the next API update.

​
Aspect Ratios and Dimensions

For video models, the dimensions parameter determines both the resolution of the video and the width x height in pixels. The exact pixel dimensions are defined by the combination of the chosen resolution and aspect ratio, so it’s important to select an aspect ratio that is supported for the chosen resolution.
  • 640x640 (1:1), 736x544 (4:3), 544x736 (3:4), 480x864 (9:16), 864x480 (16:9), 960x416 (21:9)
  • 960x960 (1:1), 1120x832 (4:3), 832x1120 (3:4), 704x1248 (9:16), 1248x704 (16:9), 1504x640 (21:9)
  • 1440x1440 (1:1), 1664x1248 (4:3), 1248x1664 (3:4), 1088x1920 (9:16), 1920x1088 (16:9), 2176x928 (21:9)

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
duration
integer
required

Duration of the video in seconds. Must be between 3 and 12.

Required range: 3 <= x <= 12
​
requestId
string<uuid> | null

Optional unique UUID v4 for the request. If not provided, a server-generated UUID will be assigned.

​
input
object
​
model
string | null

The model to use for video generation. Defaults to 'bytedance@seedance-pro-fast'.

​
seed
integer | null

Random seed for reproducibility. If not provided, a random seed is generated.

Required range: 0 <= x <= 9223372036854776000
​
dimensions
object

Response

Video generation request successfully received and queued.

​
status
number

HTTP-style status code of the response.

Example:

200

​
data
object