POST
万相 3.0 视频生成(DashScope 官方协议)

简介

万相入口以阿里云百炼 DashScope 视频生成协议对外提供服务,支持 Wan 3.0 系列模型的文生视频、首帧 / 首尾帧生视频,以及参考图、参考视频、参考音频驱动。
路径与官方 DashScope 协议一致(入口前缀为 /wan)。使用官方 DashScope SDK 时,把 SDK 的 base_url 指向 https://api.shengmoai.com/wan 即可。
视频生成是异步任务:提交接口返回 HTTP 200 只代表任务已被接受,不代表视频已经生成完成。请轮询查询接口,直到 SUCCEEDED 或 FAILED。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

支持模型

模型是否可用取决于服务端渠道配置与上游账号开通情况。上游账号未开通某个模型时,调用可能返回模型不存在 / 未开通类错误。

提交任务

POST /wan/api/v1/services/aigc/video-generation/video-synthesis

文生视频

图生视频(首帧驱动)

请求参数

顶层结构: input.prompt:文本提示词,与 media 至少其一;允许只传 media(如纯参考图 / 视频驱动)。 input.media[] 类型与数量上限(超限直接返回 400): 每个 media 项为 { "type": "...", "url": "..." },url 为非空字符串(公网 URL)。 parameters 字段:

提交响应

output.task_id 是对外任务 ID(task_ 开头),后续查询使用它。该 ID 与上游内部任务 ID 不同,仅用于本网关。

查询任务

GET /wan/api/v1/tasks/{task_id}

进行中

成功

失败

状态取值

usage 字段(成功时返回)

轮询建议间隔 5–10 秒;任务通常几十秒到几分钟完成。video_url 有时效性,请在拿到 SUCCEEDED 后尽快下载转存,也可以使用视频内容获取接口代理取回。

计费说明

  • 按「秒 × 分辨率档位」计费,档位倍率与官方价目一致(480P / 720P / 1080P = 1 : 2 : 4,有声 / 无声同价);具体单价以平台模型价格配置为准;
  • 提交时按请求的 duration(缺省按 5 秒估)与 resolution(缺省按 1080P 档估)预扣;
  • 任务完成后按 usage.duration 实测秒数与实际档位重算,多退少补;未填 duration / resolution 时的预扣偏差同样由差额结算纠正;
  • 生成失败的任务全额退款。

错误处理

所有本地校验类 400 均不产生费用。

相关页面

视频生成总览

异步流程与各入口选择

统一视频接口

多模型统一的 /v1/video/generations 入口