跳转到主要内容
POST
/
v1
/
videos
curl --request POST \
  --url https://api.powertokens.ai/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan2.7-r2v",
  "prompt": "图1朝镜头走来，轻松挥手并微笑。",
  "media": [
    {
      "type": "reference_image",
      "url": "https://example.com/assets/subject-reference.png"
    }
  ],
  "seconds": "5",
  "size": "1080P",
  "ratio": "16:9",
  "prompt_extend": true,
  "watermark": false
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "object": "video",
  "model": "<string>",
  "progress": 123,
  "created_at": 123
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json
​
model
enum<string>
必填

Ali wan2.7-r2v 模型。

可用选项:
wan2.7-r2v
​
prompt
string
必填

描述目标视频内容的提示词。当提供多个参考素材时，请在提示词中使用 图x 与 视频x 的方式引用。

​
media
object[]
必填

wan2.7-r2v 的公开多模态输入。至少包含一个 reference_image 或 reference_video，可选额外提供一个 first_frame。

​
size
enum<string>
默认值:1080P

当前公开实现支持的输出分辨率档位。

可用选项:
720P,
1080P
​
seconds
enum<string>
默认值:5

视频生成时长（秒）的字符串形式。当前默认值为 "5"。当参考素材中包含视频时：取值为[2, 10]之间的整数。当参考素材中不包含视频时：取值为[2, 15]之间的整数。

可用选项:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
​
ratio
enum<string>
默认值:16:9

输出宽高比。

可用选项:
16:9,
9:16,
1:1,
4:3,
3:4
​
negative_prompt
string

可选的反向提示词，用于描述不希望出现在结果中的内容。

​
prompt_extend
boolean

是否启用提示词改写，默认值为 true。

​
watermark
boolean
默认值:false

是否添加水印，默认值为 false。

​
seed
integer

随机种子。省略时系统自动生成。

必填范围: 0 <= x <= 2147483647

响应

提交成功，返回统一的 OpenAI 风格视频任务对象。

​
id
string

公开任务 ID。

​
task_id
string

公开任务 ID 别名。

​
object
string
示例:

"video"

​
model
string

模型名称。

​
status
enum<string>

统一视频任务状态。

可用选项:
queued,
in_progress,
completed,
failed,
unknown
​
progress
integer

任务进度百分比。

​
created_at
integer<int64>

秒级 Unix 时间戳。