文件与参考素材

本地文件不会自动变成上游可以访问的 URL。

三种常见输入方式#

文本请求直接提交文字，不需要对象存储。参考图片、视频或音频是否需要 URL，由具体上游接口决定。

客户已有对象存储#

可以直接使用自己的存储或 CDN 链接，不要求平台同时开启对象存储。确保链接可从上游服务访问，且文件类型、大小、分辨率和时长符合模型要求。

私有桶可以使用有时效的签名链接。有效期需覆盖排队、上游下载和重试过程，不能只覆盖提交请求的几秒钟。

平台代传本地素材#

平台可选支持阿里云 OSS、腾讯云 COS 和 S3 兼容存储。只有管理员启用并配置完成、且当前模型适配支持时，本地上传才可转换为临时下载链接。

对象存储默认不是所有接口通用的“文件盘”。当前 /v1/files 不是可用的通用文件上传接口；请使用模型详情中的上传方式，不要据此调用未开放的文件 API。

链接无法读取时#

先检查链接是否已过期、是否需要浏览器登录、是否存在防盗链或 IP 限制，再确认上游可以下载。localhost、127.0.0.1、内网地址和电脑上的磁盘路径不能作为公网参考素材 URL。

带签名的 URL 可能被上游用于读取素材，应视为临时访问凭据。只上传你有权使用的内容，避免在调试记录和公开截图中暴露文件或密钥。

临时文件与结果保存#

平台临时素材有有效期和清理机制，不作为长期托管。输入素材、任务结果和你自己保存的副本是不同对象。需要长期保存时，请在有效期内下载并自行归档。