Skip to main content
POST
https://dashlyai.cc
/
v1
/
videos
/
generations
curl --request POST \
  --url https://dashlyai.cc/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-0-pro-fast",
    "prompt": "Spaceship traversing through nebula, spectacular space scene",
    "size": "16:9"
  }'

{
  "id": "task_vid_xyz789ghi012",
  "object": "generation.task",
  "model": "doubao-seedance-1-0-pro-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • ByteDance Doubao video generation model
  • Use model parameter to select doubao-seedance-1-0-pro-fast or doubao-seedance-1-0-pro-quality model
  • Supports text-to-video generation
  • Supports first frame / last frame / reference image control
  • Async task management, query results by task ID

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"doubao-seedance-1-0-pro-fast"
required
Video generation model nameAvailable models:
  • doubao-seedance-1-0-pro-fast - Fast version (40-90 seconds generation)
  • doubao-seedance-1-0-pro-quality - Quality version (90-300 seconds generation)
​
prompt
string
required
Text description for video generation
​
duration
integer
Video duration (seconds)Supports: 2~12 seconds
​
size
string
Video aspect ratioSupported formats:
  • 16:9 (landscape)
  • 9:16 (portrait)
  • 1:1 (square)
  • 4:3 (landscape standard)
  • 3:4 (portrait standard)
  • 21:9 (ultra wide)
​
image_with_roles
array
Images array with roles, for first frame / last frame / reference controlEach element contains:
  • url (string): Image URL or Base64
  • role (string): Image role
    • first_frame - First frame, as video start
    • last_frame - Last frame, as video end
    • reference - Reference image, guides video style (not supported in 1080p)
⚠️ Note: image_with_roles and images cannot be used together
​
metadata
object
Advanced parameter configurationDoubao supported parameters:
ParameterTypeDescription
resolutionstringVideo resolution: 480p, 720p (default), 1080p

​
Response

​
id
string
Unique task identifier for status queries
​
object
string
Object type, always generation.task
​
model
string
Model name used
​
status
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
​
progress
integer
Task progress percentage (0-100)
​
created_at
integer
Task creation timestamp (Unix timestamp)
​
metadata
object
Task metadata
curl --request POST \
  --url https://dashlyai.cc/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-0-pro-fast",
    "prompt": "Spaceship traversing through nebula, spectacular space scene",
    "size": "16:9"
  }'

{
  "id": "task_vid_xyz789ghi012",
  "object": "generation.task",
  "model": "doubao-seedance-1-0-pro-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}