Skip to main content
POST

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

模型名称。可用值:wan2.7-i2v

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

用于视频生成的媒体资源(图片、音频、视频)列表。每个元素都是一个包含 typeurl 的媒体对象。

支持的组合(非法组合会返回错误):

  • 仅首段视频first_clip
  • 首段视频 + 尾帧first_clip + last_frame

数组中每个 type 最多出现一次。

prompt
string

描述期望视频内容与视觉特征的文本提示词。支持中英文,最多 5000 个字符(每个汉字、字母、数字、标点均计为 1 个字符)。超出部分会自动截断。

size
enum<string>
默认值:1080P

指定输出分辨率档位,用于控制视频清晰度(总像素数)。

模型会根据所选分辨率档位自动缩放到相近的总像素数。视频宽高比会尽量保持与输入素材(首帧或首段视频)一致。

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

视频时长(字符串形式)。支持 215 的整数字符串。

可用选项:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
negative_prompt
string

负向提示词,描述不希望出现的视频内容。支持中英文,最多 500 个字符。超出部分会自动截断。示例:低分辨率、最差质量、变形、多余手指、比例失调

prompt_extend
boolean

是否开启智能改写提示词。开启后,会使用大模型对输入提示词进行智能改写,对短提示词效果提升显著,但会增加处理耗时。true(默认):开启。false:关闭。

watermark
boolean
默认值:false

是否添加水印。水印位于右下角,文字为“AI生成”。false(默认):不添加。true:添加。

seed
integer

随机种子,范围 [0, 2147483647]。未指定时系统自动生成随机种子。为了获得更稳定的复现效果,建议设置固定种子。注意:由于模型生成具有概率性,即使相同种子也不能保证每次结果完全一致。

必填范围: 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 时间戳(秒)。