哪些素材需要公网链接
URL 拉取型视频协议需要远端能读取的素材地址。multipart 图片编辑可以直接上传文件字节，不必强制把所有图片中转成 URL。
blob: 地址、电脑本地路径、私网地址和依赖浏览器登录态的链接，不能假设生成服务可访问。
素材交付检查
- HTTPS 证书有效，域名和完整证书链正确；不能关闭证书校验来绕过错误。
- 远端 HEAD/GET 能获取真实文件，检查 MIME、长度、实际解码结果；视频按需支持 Range。
- URL 授权期限覆盖整个任务可能读取素材的时间；长任务需要合理续租。
- 文件数量、大小、编码和媒体时长符合当前模型限制。
- 保持引用顺序。内部节点的
role/type不等于最终接口必须接受这些字段。
https://your-public-relay.example 仅是本文的客户中转域名占位符，不是奶龙 API 提供的上传服务。
如果你开发素材中转
建议流程：用户鉴权与文件归属校验 → 真实格式/大小检查 → 必要转码 → 隔离临时存储 → 限时授权 URL → 保存任务和素材租期 → 到期清理。
限制单文件、总容量、并发和有效期。客户后端拉取 URL 时还应校验目标与重定向，避免任意远程抓取和内部网络访问。素材签名地址、授权 Token 和真实媒体不写入公开日志。
音频兼容
历史相关参考工作流采用真正 MP3 作为兼容策略，但不能推广为所有模型都禁止 WAV/M4A。按当前模型契约选择格式。需要转换时用媒体工具检测编码、实际转码并验证；把扩展名改成 .mp3 不算转码。
常见素材问题
| 现象 | 检查方向 |
|---|---|
| 不存在的素材路径返回404 | 不能据此证明实际媒体可访问；检查真实授权链接 |
| 上传成功，上游无法读取 | 公网可达性、链接租期、登录依赖、MIME与文件内容 |
| HTTPS 错误 | DNS、证书链、域名、TLS，不要用关闭校验掩盖 |
| 提示文件太大 | 区分上传入口、中转存储、反向代理和模型各层限制 |
| 部分下载或视频无法播放 | 长度、Range、传输完整性、真实编码与解码 |
若使用反向代理，核对路径前缀、查询参数、上传大小和超时。不能直接复制别人的代理配置、证书目录或限制数值。