跳转到主要内容
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": "一只小猫在草地上奔跑,阳光明媚,镜头跟随移动",
  "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
}

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

视频生成模型名称。支持的模型包括 seedance-1-5-pro-251215seedance-1-0-pro-250528seedance-1-0-pro-fast-251015。三者均支持文生视频与首帧图生视频;其中 seedance-1-5-pro-251215 额外支持 generate_audiodraftreturn_last_frame

可用选项:
seedance-1-5-pro-251215,
seedance-1-0-pro-250528,
seedance-1-0-pro-fast-251015
prompt
string
必填

文本提示词,描述期望生成的视频内容。建议中文不超过 500 字,英文不超过 1000 词。

image
string

首帧图片 URL 或 Base64 编码。用于首帧图生视频场景。

seconds
string
默认值:5

视频生成时长(秒)的字符串形式。seedance-1-5-pro-251215 支持 "-1"(自动选择)或 "4""12";其他模型支持 "2""12"

示例:

"5"

size
enum<string>

视频输出规格参数。样片模式(draft=true)仅支持 480p。1.5-pro 默认 720p,1.0-pro / 1.0-pro-fast 默认 1080p。

可用选项:
480p,
720p,
1080p
ratio
enum<string>
默认值:16:9

视频宽高比。文生视频默认 16:9(seedance-1-5-pro-251215 默认 adaptive),首帧图生视频默认 adaptive

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
seed
integer
默认值:-1

随机数种子,取值范围 [-1, 4294967295]。

camera_fixed
boolean
默认值:false

是否固定摄像头。

watermark
boolean
默认值:false

是否添加水印。

generate_audio
boolean
默认值:true

是否生成与画面同步的声音。仅 seedance-1.5-pro 支持。

draft
boolean
默认值:false

是否开启样片模式。开启后生成预览视频,速度更快但质量较低。仅 seedance-1.5-pro 支持。

return_last_frame
boolean
默认值:false

是否返回尾帧图像。开启后可通过查询接口获取视频尾帧。

响应

提交成功,返回视频任务对象。

id
string
task_id
string
object
string
示例:

"video"

model
string
status
enum<string>

任务状态。

可用选项:
pending,
queued,
running,
succeeded,
failed,
cancelled,
expired
progress
integer
created_at
integer<int64>