素材怎么准备

什么是素材直链

直链是打开后能直接下载图片、视频或音频的网络地址。WAN3 当前接入采用 JSON，请求中的素材使用 HTTPS 直链；本地文件路径不能直接提交。

可以在未登录的浏览器窗口试着打开地址：应看到文件本身，而不是登录页或网盘预览页。这只是初步检查，接入程序还应实际下载检查，不能只看 HEAD 成功。

我只有本地文件怎么办

请使用你自己或团队信任的对象存储/素材托管工具，上传后复制文件直链。私密存储可使用有效期足够长的签名地址。没有存储时，可以先做不带素材的文生视频测试，再让 AI 协助配置素材托管。

本站文档页没有素材上传功能，也不会替你把照片发布到图床。

这些地址不能用

• C:\\Users\\name\\Desktop\\photo.png 等电脑路径。
• file:、blob: 开头的本地或临时浏览器地址。
• 要输入提取码、登录或点击“下载”按钮的网盘页面。
• 只能在公司内网或你自己电脑访问的地址。

需要保持多久有效

素材应在整个排队和生成期间能被读取。不要设置几分钟就失效的签名地址；分享时原样保留其查询参数。素材不要在任务完成前删除。

图片、音频和视频怎么填

优先使用 接口说明 的顶层 reference_images、reference_videos、reference_audios。它们都是对象数组，而不是 URL 字符串数组。

图片文档约定最多 10 张，按需要使用尽量少的素材。首尾帧角色是 first_frame 与 last_frame；音频参考不等于保证输出一定带有声音。

参考视频只适用于 video 系列，必须填写明确时长；限制见 模型与计费。素材格式、体积还受模型实际处理能力限制。

报错 read image failed

它表示模型处理链路未能读取图片；可能是图片源响应慢、直链过期或服务间网络问题，不能仅凭报错确定是谁的责任。先检查原地址，换稳定素材源后再决定是否发起新任务。