跳转到主要内容
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-i2v",
  "prompt": "一只猫从静止逐渐开始走动，画面充满活力。",
  "media": [
    {
      "type": "first_frame",
      "url": "https://example.com/assets/cat.png"
    }
  ],
  "seconds": "5",
  "size": "1080P"
}
'
{
  "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-i2v 模型。

可用选项:
wan2.7-i2v
​
media
object[]
必填

多模态输入字段。本场景仅允许 first_frame 和 driving_audio 类型。

​
prompt
string

可选文本提示词。未提供时，生成过程将主要依赖输入媒体素材。

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

当前项目实现支持的输出分辨率档位。

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

视频时长的字符串形式。当前支持 2 到 15 的整数字符串。

可用选项:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
​
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 秒级时间戳。