Wan 视频生成

wan3.0-video 系列使用 JSON 请求体提交异步视频任务，生成参数放在 对象中。

POST /v1/videos

• 支持文生视频、首帧生视频、首尾帧生视频、参考图/视频/音频、参考文件和参考网页模式。
• 首尾帧模式与参考素材模式互斥； 与 不能同时使用。
• 异步处理：提交后返回 id 或 task_id。

当前可用模型

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：
	string	是	请求内容类型，必须设置为

请求体

名称	类型	必填	说明
	string	是	模型名称
	string	否	视频提示词，支持中英文；与 至少提供一个
	object	是	媒体素材与视频生成参数

metadata

名称	类型	必填	说明
	array<object>	否	媒体素材列表，每项含 与 （公网 URL、临时 OSS URL 或图像 Base64 Data URL）；与顶层 至少提供一个
	string	否	分辨率：、、，默认 ；小写自动转大写
	string	否	画面比例：、、、、、，默认
	integer	否	输出时长：无参考视频时取 –，默认 ；传 开启智能时长
	boolean	否	是否生成音轨，默认
	integer	否	随机种子，范围 –
	boolean	否	提示词智能改写，默认
	boolean	否	是否加水印，默认

媒体素材类型

	最大数量	说明
	1	首帧图像，严格作为视频第一帧
	1	尾帧图像，严格作为视频最后一帧
	10	参考图像
	5	参考视频，总时长不超过 15 秒
	5	参考音频，总时长不超过 15 秒
	1	参考文件；不能与 同时使用
	1	公开网页；不能与 同时使用

素材限制：图像（JPEG/JPG/PNG/BMP/WEBP，PNG 不支持透明通道，≤20 MB，单边 240–8000 像素，长宽比 ≤ 8:1）；视频（MP4/MOV，≤100 MB，单段 1–15 秒）；音频（WAV/MP3，≤15 MB，单段 1–15 秒）；文件（DOCX/XLSX/PPTX/PDF/TXT/MD 等，≤100 MB，分页格式 ≤ 50 页）；网页（无需登录的公开 HTTP/HTTPS）。

请求示例

文生视频

curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan3.0-video",
  "prompt": "一只小猫在月光下的屋顶上奔跑，远处是城市霓虹灯，电影级画质，流畅运镜。",
  "metadata": {
    "resolution": "1080P",
    "ratio": "16:9",
    "duration": 5,
    "audio": true,
    "seed": 123456789,
    "prompt_extend": true,
    "watermark": false
  }
}'

响应示例

{
  "id": "task_1234567890abcdef",
  "object": "video",
  "model": "wan3.0-video-prime",
  "status": "queued",
  "progress": 0,
  "created_at": 1787673600,
  "metadata": {
    "url": ""
  }
}

响应字段

名称	类型	说明
	string	任务 ID，后续轮询使用
	string	固定为
	string	实际使用的模型
	string	任务状态：、、 等
	integer	进度百分比
	integer	创建时间戳
	string	完成后的结果视频地址

相关接口

• 视频系列概览
• Wan 任务查询
• 错误码查询