通义万相

通义万相同时存在两条产品路径：面向普通创作者的万相网页入口，以及阿里云 Model Studio 中可编程的视频模型 API。两者的版本名和上线节奏并不完全一致。2026 年 8 月 12 日核对时，网页首页已展示“万相 3.0”和原生 30 秒、参考生成、视频编辑等入口；Model Studio 国际区文档则仍以 Wan 2.7 系列 API 为主要可调用版本。

网页版本不能替代 API 型号

不要因为网页写着“3.0”，就在代码里猜测存在同名 API；也不要因为 API 文档列 Wan 2.7，就判断网页端没有更新。正式项目应把网页产品名、API model 字符串、地域和核对日期分别记录。

按输入控制方式选视频任务

Model Studio 文档把通用视频能力拆为文生视频、首帧图生视频、首尾帧视频、参考生视频和通用视频编辑等路径。文生视频适合从脚本建立镜头；首帧固定主体和初始构图；首尾帧提供起点与落点；参考生视频更强调人物、声音或故事板参考；已有素材的局部替换、延长和画幅扩展则应看视频编辑能力。

国际区 Wan 2.7 的可核验范围

当前国际区文档列出的 Wan 2.7 文生视频支持中文和英文提示、720P/1080P、2 至 15 秒区间，并可输入音频以生成带声音的视频；参考生视频还可使用人物与声音参考。不同部署范围、地域和具体模型的能力并不相同，不能把一张规格表套到所有账号。

API 调用先锁定地域

1. 在控制台确认实际可用的 model 名称和部署范围。
2. 使用同地域的 Endpoint、Workspace 与 API Key；跨地域组合会失败。
3. 提交异步任务并保存 task_id，按退避策略轮询状态。
4. 记录提示词、参考素材、分辨率、时长、音频和模型快照。
5. 成功后立即把结果转存到自己的对象存储；官方文档说明部分输出 URL 仅保留 24 小时。

万相网页入口与 Model Studio API 的版本和交付方式不同，但仍可使用同一镜头包比较提示遵循、参考控制、音画同步和返工成本。把通义万相与其他视频平台统一试片能帮助判断应继续使用网页工作台，还是进入可编程管线。

用同一镜头比较网页与 API

准备一个人物镜头、一个复杂运动镜头和一个产品结构镜头，在网页与 API 使用相同参考素材和验收项。记录提示遵循、人物一致性、音画同步、编辑后漂移、失败率、生成时间与真实费用。网页端适合快速体验新能力，API 适合可重复管线；最终选择取决于交付方式，而不是只看版本数字。

素材边界：人物、声音、商标和客户素材应先取得授权。生成结果还需人工检查事实、文字、品牌一致性和内容安全。官网：https://tongyi.aliyun.com/wan/；开发者模型以阿里云 Model Studio 当前地域文档和控制台为准。