Skip to main content
POST
/
v1
/
videos
curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-1-5-pro-251215",
  "prompt": "A kitten running on grass, sunny day, camera following",
  "seconds": "5",
  "size": "720p",
  "ratio": "16:9",
  "generate_audio": true
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "status": "pending",
  "progress": 123,
  "created_at": 123
}

Authorizations

Authorization
string
header
required

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

Body

application/json
model
enum<string>
required

Video generation model name. Supported models include seedance-1-5-pro-251215, seedance-1-0-pro-250528, and seedance-1-0-pro-fast-251015. All three support text-to-video and first-frame image-to-video. seedance-1-5-pro-251215 additionally supports generate_audio, draft, and return_last_frame.

Available options:
seedance-1-5-pro-251215,
seedance-1-0-pro-250528,
seedance-1-0-pro-fast-251015
prompt
string
required

Text prompt describing desired video content. Recommended max 500 Chinese characters or 1000 English words.

image
string

First-frame image URL or Base64-encoded input for first-frame image-to-video.

seconds
string
default:5

String form of the video duration in seconds. seedance-1-5-pro-251215 accepts "-1" (auto-select) or "4" to "12"; other models accept "2" to "12".

Example:

"5"

size
enum<string>

Public output size tier and billing field. Draft mode only supports 480p. 1.5-pro defaults to 720p, while 1.0-pro and 1.0-pro-fast default to 1080p.

Available options:
480p,
720p,
1080p
ratio
enum<string>
default:16:9

Video aspect ratio. Text-to-video defaults to 16:9 (seedance-1-5-pro-251215 defaults to adaptive), while first-frame image-to-video defaults to adaptive.

Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
seed
integer
default:-1

Random seed, range [-1, 4294967295].

camera_fixed
boolean
default:false

Whether to fix camera.

watermark
boolean
default:false

Whether to add watermark.

generate_audio
boolean
default:true

Whether to generate audio synchronized with video. Only seedance-1.5-pro supports.

draft
boolean
default:false

Whether to enable draft mode. Generates preview video faster but lower quality. Only seedance-1.5-pro supports.

return_last_frame
boolean
default:false

Whether to return last frame image. Can get video last frame via query interface when enabled.

Response

Submission successful, returns video task object.

id
string
task_id
string
object
string
Example:

"video"

model
string
status
enum<string>

Task status.

Available options:
pending,
queued,
running,
succeeded,
failed,
cancelled,
expired
progress
integer
created_at
integer<int64>