POST /v2/videos/generations

Method: POSTEndpoint: /v2/videos/generations

Unified Interface Format

Request Parameters

Header Parameters

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

prompt
string
Required
  // provider-specific example normalized for English documentation
model
enum<string>
Required
Model name. Example: doubao-seedance-1-0-pro-250528
Enum Values:
doubao-seedance-1-0-pro-250528
Latest models
  // provider-specific example normalized for English documentation
doubao-seedance-1-0-lite-t2v-250428
Text-to-Video
doubao-seedance-1-0-lite-i2v-250428
Image-to-Video - first frame / start-end frames / reference image
duration
enum<integer>
Optional
Duration of the generated video in seconds. This parameter is fixed at 5 and cannot be changed. The model always generates a 5-second video.
Enum Values:
5
10
Default Value:
5
resolution
enum<string>
Video resolution
Optional
Enum Values:
480p
720p
1080p
Default Value:
480p
ratio
string
Optional
Aspect ratio of the generated video
21:9
16:9
4:3
1:1
3:4
9:16
9:21
keep_ratio: the generated video's aspect ratio stays consistent with the uploaded image.
adaptive: automatically chooses the most suitable aspect ratio based on the uploaded image.
Default Value:
16:9
watermark
boolean
Optional
Specifies whether to add a watermark. The watermark appears in the lower-right corner and reads "Generated by AI".
Default Value:
false
seed
integer
Optional
A random seed used to control the randomness of the generated content. The value must be in the range [0, 2147483647].
If this parameter is not provided, the algorithm automatically generates a random seed. To keep the generated content relatively stable, reuse the same seed value.
camerafixed
boolean
Optional
Whether to lock the camera
true: locks the camera. The platform appends a fixed-camera instruction to the prompt, but the effect is not guaranteed.
false: does not lock the camera.
Default Value:
false
return_last_frame
boolean
Optional
true: returns the last frame of the generated video as a PNG image with the same dimensions as the video and no watermark. You can obtain it through the video-task query endpoint.
false: does not return the last-frame image.
Default Value:
false
generate_audio
boolean
Optional
Example
{
"prompt"
:
"dance"
,
"model"
:
"doubao-seedance-1-0-lite-t2v-250428"
}

Example Request

Shell

curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "dance",
    "model": "doubao-seedance-1-0-lite-t2v-250428"
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

task_id
string
Required

Example

{
    "task_id": "cgt-20250831141439-sqmgf"
}