使用指南用户指南
自有存储:生成结果永久保存
配置你自己的阿里云 OSS 或 Cloudflare R2 存储桶,视频/图片生成结果自动转存,链接永久有效。
为什么需要自有存储
视频、图片生成任务的结果默认存放在上游服务商的临时存储中,有保留期限制(通常 24 小时~48 小时),过期后链接失效、无法再下载。
在 个人资料 → 存储设置 配置你自己的存储桶后:
- 视频 / 图片任务成功时,平台自动把结果文件转存到你自己的桶;
- 任务返回的
result_url直接指向你的存储,不再过期; - 数据归属你自己,可自由做 CDN 分发、备份与生命周期管理。
转存过程完全在服务端进行;如果某次转存失败,会自动回退为平台默认链接,不影响你获取结果。
支持的存储服务
| 服务 | 说明 |
|---|---|
| 阿里云 OSS | 推荐国内用户使用,支持传输加速 Endpoint |
| Cloudflare R2 | S3 兼容,无出口流量费,推荐海外用户使用 |
配置步骤:阿里云 OSS
- 在 阿里云 OSS 控制台 创建一个 Bucket(或使用已有 Bucket)。
- 建议在 RAM 控制台 创建一个仅用于此用途的子用户,生成 AccessKey,并只授予该 Bucket 的读写权限。最小权限策略示例:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": ["oss:PutObject", "oss:GetObject"],
"Resource": ["acs:oss:*:*:你的bucket名/*"]
}
]
}- 回到 个人资料 → 存储设置,打开开关并选择「Aliyun OSS」,填写:
| 字段 | 填写内容 |
|---|---|
| OSS Endpoint | Bucket 所在地域的 Endpoint,如 https://oss-cn-hangzhou.aliyuncs.com |
| OSS Bucket | Bucket 名称 |
| 传输加速 Endpoint(可选) | 如 https://oss-accelerate.aliyuncs.com,跨境上传更快 |
| AccessKey ID / Secret | 上一步生成的子用户密钥 |
| 对象前缀(可选) | 文件统一存放的目录前缀,如 ai-results |
| 公开访问域名(可选,推荐) | Bucket 绑定的 CDN / 自定义域名,如 https://cdn.example.com |
- 点击 测试上传:平台会向你的桶写入一个
test.txt并返回访问链接,打开链接能看到内容即配置成功。 - 点击 保存设置。
配置步骤:Cloudflare R2
- 在 Cloudflare 控制台 → R2 创建一个存储桶。
- 创建 R2 API 令牌(R2 → Manage R2 API Tokens),权限选择「Object Read & Write」,并限定到该桶。记下 Access Key ID 与 Secret Access Key。
- 回到 个人资料 → 存储设置,打开开关并选择「Cloudflare R2」,填写:
| 字段 | 填写内容 |
|---|---|
| R2 Endpoint | https://<account-id>.r2.cloudflarestorage.com(在 R2 概览页可复制) |
| R2 Bucket | 桶名称 |
| AccessKey ID / Secret | 上一步生成的 API 令牌密钥 |
| 对象前缀(可选) | 文件统一存放的目录前缀 |
| 公开访问域名(强烈建议) | 为桶绑定的公开自定义域名,如 https://media.example.com |
- 点击 测试上传 验证,然后 保存设置。
⚠️ R2 注意:如果不配置公开访问域名,平台只能生成带签名的临时链接,最长 7 天有效(S3 预签名协议上限)。要获得永久链接,请务必为 R2 桶绑定公开自定义域名。阿里云 OSS 无此限制(未配公开域名时签名链接默认 10 年有效)。
生效后的行为
- 视频任务:任务成功后结果自动转存,存放路径为
[对象前缀/]task-results/<日期>/<任务ID>.mp4,任务查询返回的result_url即你的桶地址。 - 图片生成:转存图片存放在
[对象前缀/]relay-temp-images/<日期>/下。 - 转存失败(如密钥失效、桶不可写)时自动回退平台默认链接,任务结果不受影响;建议定期用「测试上传」确认配置有效。
安全说明
- AccessKey Secret 在服务端加密存储,任何接口都不会回显;编辑配置时留空即表示保留原密钥。
- 上传全部在服务端进行,密钥不会下发到浏览器或任何客户端。
- 建议使用最小权限的子账号密钥(仅目标桶的读写权限),并定期轮换。
常见问题
测试上传失败怎么排查? 依次检查:Endpoint 地域与 Bucket 是否匹配、Bucket 名称拼写、AccessKey 是否有该桶的写权限(PutObject)、密钥是否已过期或被禁用。错误信息中会包含存储服务返回的具体原因。
为什么返回的链接带一长串签名参数? 未配置「公开访问域名」时,桶按私有读处理,平台会生成带签名的链接。配置公开访问域名(公共读 Bucket 或 CDN 域名)后即为干净的永久直链。
开启后历史任务的链接会变吗? 不会。转存只对开启后新完成的任务生效,历史任务仍是原链接。
只想转存视频、不想转存图片可以吗? 目前是统一开关,开启后视频与图片结果都会转存到你的桶。