跳转到主要内容
POST
提交 Wan 2.5 文生视频任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
wan2.5-text-to-video 是 Wan 2.5 视频系列中的纯文本分支,支持多种尺寸预设,可生成 5 秒和 10 秒的视频。

模型

  • wan2.5-text-to-video - 根据文本提示词生成视频片段

关键参数

  • 宽高比:832*480、480*832、1280*720、720*1280、1920*1080、1080*1920
  • 时长:5 或 10 秒
  • 可选控制:audio 字符串、negative_prompt、seed

工作流 ID

原有 ID 仍可使用。新接入可选择专用的工作流:

注意事项

  • 如果提供 audio,必须是字符串,不要传布尔值。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

访问 API Key 管理页面(仪表盘 → API 密钥)获取 API Key

添加到请求头:

请求体

application/json
model
string
必填
示例:

"wan2.5-text-to-video"

input
object
必填

生成参数

callback_url
string<uri>

用于接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填