# 文件与参考素材

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

## 三种常见输入方式

| 方式 | 使用条件 |
| --- | --- |
| HTTPS URL | 上游能够直接下载，链接在任务读取期间有效 |
| Base64 / data URL | 模型接口明确支持该形式，并满足体积限制 |
| multipart 本地上传 | 该端点和模型适配明确支持文件字段 |

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

## 客户已有对象存储

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

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

## 平台代传本地素材

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

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

## 链接无法读取时

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

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

## 临时文件与结果保存

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