本文内容（10节）
万相有两个入口：网页创作与百炼API先选清楚
“通义万相”不是一个固定按钮页面的名字。普通创作者通常从万相创作网页使用；开发者可能在阿里云百炼通过API接入。两种入口的教程不能混写，API字段名也不是网页按钮名。
| 你要做什么 | 该看哪个入口 |
|---|---|
| 手动输入描述或上传图片，预览生成结果 | 万相官方创作网页。先看当前模型提供的输入模式。 |
| 把视频生成接入自己的程序、批量流程或业务系统 | 阿里云百炼文档，需配置实际支持的模型、地域与鉴权。 |
开始前，先回答自己需不需要API
只是手工制作几条镜头，可以先在网页创作入口中选择当前可用模型，准备提示词与对应素材。需要接入自建工具、批量提交或保存任务状态，才进入百炼等开发者文档。网页会员、云服务密钥与不同地域资源，不应被当成同一套条件。
在百炼当前文档中，模型、Endpoint与API Key需要属于同一地域。请求失败时先核对这些基础条件，再检查业务空间与模型权限。不要把所有接入错误都归因于视频提示词。
对普通制作人员，只需让维护者说明自己在用什么入口、哪些模式可用、结果怎样下载。密钥由相应系统妥善配置，不需要发到聊天或写进公开教程截图。
网页使用者应先确认的三件事
一是当前任务需要文字、参考素材还是首尾帧；二是所选模型实际支持哪些输入；三是画幅、时长和费用怎样显示。本文不把百炼的first_frame、last_frame参数冒充为创作网页里的按钮。
用同一个故事，分别安排三种输入
要做“雨后邮差把信放进信箱”，没有图片时，文字需要交代邮差、街道、信箱、构图与动作。参考模式可以让人物板提供身份、场景图提供环境，再用文字安排投信。首帧模式则应先准备邮差站在箱旁、手持信件的剧情画面。
首尾帧还需要合理落点：信已进入箱内，手已离开，身体仍能接下一步。不能拿一张正面肖像当开始，另一张远处街景当结束，却希望中间自动完成所有投信细节。
当前wan3文档区分相应素材类型与可组合范围。按任务选择，不把首帧、参考图、文档与声音全部混装。输入种类多，首先意味着需要更明确分工。
读万相3.0 API文档时怎么对照
纯文字任务用描述构建画面；首帧任务提供起始图；首尾帧任务同时约束开场和结束；参考素材则用于指定主体或内容线索。文档中不同媒体类型有各自字段，程序提交时应使用对应协议，不把旧模型参数直接搬过来。
提交成功与拿到视频是两个阶段
API调用需按对应文档处理返回值和任务结果；记录任务标识、失败信息和最终文件位置。网页端则在实际生成记录里查看结果。不能把显示“提交成功”写成已经生成了可播放文件。
本站能提供到哪一步
这里给的是入口与文档选择方法。账号内创作页布局及一次完整API调用没有在本页实测，因此不提供猜测的菜单位置、假造返回值或可用率。需要接入时直接按下方官方模型指南核对。
网页用户可以先做一个最小镜头
例如只拍一位修车师傅把扳手放回工具架。文生视频需要说明人物、车间、构图与动作；若已有确定画面，就先看当前模型怎样使用首帧；若只想沿用角色身份，则核对参考素材模式。先把入口选对，再调整画幅和其他设置。
这一轮可以固定机位，只做放回工具一个动作。生成结果出现问题时，就能分别看人物是否正确、动作是否成立、工具架空间是否合理。第一次同时要求绕行、对白和多场景切换，会让排错困难得多。
开发者先核对服务范围，而不是先改提示词
官方文档区分地域、模型与鉴权配置。模型、服务地址和凭据应对应同一适用范围；请求失败时，先读返回信息，确认它是否到达模型任务阶段。认证和参数错误，不应该靠润色镜头文字解决。
文档示例里的字段、媒体引用方式与返回格式，应按当前版本使用。旧模型的参数名即使看起来相似，也不能直接推定有效。配置中需要保存完整型号与版本，避免程序只记“万相”这个产品名。
文件与网页输入，先确认内容真的可读
把剧本资料交给模型前，筛选与当前镜头有关的部分，并说明主要人物与目标。文档容量大，不代表必须上传整本设定。公开网页引用与私有文档上传，也应按入口规则处理。
生成后逐项核对专名、产品信息和必须准确的内容。模型读到资料，只说明输入参与了任务，不能保证最终画面中的每个字都正确。用于对外介绍时，这一步不能省。
资料：百炼万相3.0任务类型与接入说明。邮差镜头为本站自拟示例。
任务结果需要落到可用文件
提交、查询状态、获取结果与下载保存，应该分别有记录。拿到任务标识，说明请求被接受；视频能够下载并正常播放，才说明输出到手。进一步是否能进入作品，还需要检查内容、画幅与声画关系。
批量处理时，保留每个任务对应的镜头与输入，失败原因不要全部归为“重试”。能够区分临时问题和明确无效请求，有助于减少重复消耗。密钥等凭据应留在合适的本地配置中，不要随任务日志公开。
批量任务先保住镜头与文件的对应
每次提交都绑定镜头编号、资料版本与提示词，保存任务标识。成功后下载原始文件，再建立采用记录。一个在线地址能打开，不代表它应该成为唯一素材存档。
如果查询失败，先分清任务还在进行、接口出错还是结果下载失败。重新下载已成功结果，与重新提交付费生成，是不同操作。自建工具应让使用者看得出自己正在做哪一种。
结果进入剪辑后，再检查声音、画幅与实际时长。若一条人物动作需要更多反应时间，可以调整分镜，而不是单纯把全部视频延长。模型支持范围是选择条件，故事安排仍需制作判断。
把模型能力表与自己的需求对齐
有些任务更依赖角色参考，有些只需要一个固定首帧动作，还有些需要编辑已有片段。先列出本次必须满足的条件，再选择型号和模式。不能把一整个系列的介绍拼成任意入口都具备的万能功能。
本页提供的是入口选择、任务准备与结果管理方法。网页账号内的按钮位置、实际可用权限与当前费用，仍需当时核对；本站没有在这篇文章中执行完整 API 流程，因此也不提供虚构的响应样例或成功率。
把接口问题与镜头问题分成两份记录
认证、地域或参数错误，记录服务与返回信息；人物行为不对，记录输入、采用型号与具体时间点。开发者和制作人员需要的线索不同，混成一句“没出好”会让双方都难处理。
最小任务跑通以后，再增加多参考、声音与更长时长。每加一层就保存成功样本，后面出现问题能回到最近一次可靠状态。
批量生产尤其需要这种渐进验证，否则几十条任务一起失败，也很难知道从哪里开始查。
资料来源与延伸阅读
资料复核：2026年11月4日。文中的自拟情节、演算与检查方法用于教学；产品能力以对应版本的公开说明为依据，未将文档核对写成账号实测。