Models Hub
使用指南用户指南

自有存储:生成结果永久保存

配置你自己的阿里云 OSS 或 Cloudflare R2 存储桶,视频/图片生成结果自动转存,链接永久有效。

编辑此页

为什么需要自有存储

视频、图片生成任务的结果默认存放在上游服务商的临时存储中,有保留期限制(通常 24 小时~48 小时),过期后链接失效、无法再下载。

个人资料 → 存储设置 配置你自己的存储桶后:

  • 视频 / 图片任务成功时,平台自动把结果文件转存到你自己的桶
  • 任务返回的 result_url 直接指向你的存储,不再过期
  • 数据归属你自己,可自由做 CDN 分发、备份与生命周期管理。

转存过程完全在服务端进行;如果某次转存失败,会自动回退为平台默认链接,不影响你获取结果。

支持的存储服务

服务说明
阿里云 OSS推荐国内用户使用,支持传输加速 Endpoint
Cloudflare R2S3 兼容,无出口流量费,推荐海外用户使用

配置步骤:阿里云 OSS

  1. 阿里云 OSS 控制台 创建一个 Bucket(或使用已有 Bucket)。
  2. 建议在 RAM 控制台 创建一个仅用于此用途的子用户,生成 AccessKey,并只授予该 Bucket 的读写权限。最小权限策略示例:
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["oss:PutObject", "oss:GetObject"],
      "Resource": ["acs:oss:*:*:你的bucket名/*"]
    }
  ]
}
  1. 回到 个人资料 → 存储设置,打开开关并选择「Aliyun OSS」,填写:
字段填写内容
OSS EndpointBucket 所在地域的 Endpoint,如 https://oss-cn-hangzhou.aliyuncs.com
OSS BucketBucket 名称
传输加速 Endpoint(可选)https://oss-accelerate.aliyuncs.com,跨境上传更快
AccessKey ID / Secret上一步生成的子用户密钥
对象前缀(可选)文件统一存放的目录前缀,如 ai-results
公开访问域名(可选,推荐)Bucket 绑定的 CDN / 自定义域名,如 https://cdn.example.com
  1. 点击 测试上传:平台会向你的桶写入一个 test.txt 并返回访问链接,打开链接能看到内容即配置成功。
  2. 点击 保存设置

配置步骤:Cloudflare R2

  1. Cloudflare 控制台 → R2 创建一个存储桶。
  2. 创建 R2 API 令牌(R2 → Manage R2 API Tokens),权限选择「Object Read & Write」,并限定到该桶。记下 Access Key ID 与 Secret Access Key。
  3. 回到 个人资料 → 存储设置,打开开关并选择「Cloudflare R2」,填写:
字段填写内容
R2 Endpointhttps://<account-id>.r2.cloudflarestorage.com(在 R2 概览页可复制)
R2 Bucket桶名称
AccessKey ID / Secret上一步生成的 API 令牌密钥
对象前缀(可选)文件统一存放的目录前缀
公开访问域名(强烈建议)为桶绑定的公开自定义域名,如 https://media.example.com
  1. 点击 测试上传 验证,然后 保存设置

⚠️ R2 注意:如果不配置公开访问域名,平台只能生成带签名的临时链接,最长 7 天有效(S3 预签名协议上限)。要获得永久链接,请务必为 R2 桶绑定公开自定义域名。阿里云 OSS 无此限制(未配公开域名时签名链接默认 10 年有效)。

生效后的行为

  • 视频任务:任务成功后结果自动转存,存放路径为 [对象前缀/]task-results/<日期>/<任务ID>.mp4,任务查询返回的 result_url 即你的桶地址。
  • 图片生成:转存图片存放在 [对象前缀/]relay-temp-images/<日期>/ 下。
  • 转存失败(如密钥失效、桶不可写)时自动回退平台默认链接,任务结果不受影响;建议定期用「测试上传」确认配置有效。

安全说明

  • AccessKey Secret 在服务端加密存储,任何接口都不会回显;编辑配置时留空即表示保留原密钥
  • 上传全部在服务端进行,密钥不会下发到浏览器或任何客户端。
  • 建议使用最小权限的子账号密钥(仅目标桶的读写权限),并定期轮换。

常见问题

测试上传失败怎么排查? 依次检查:Endpoint 地域与 Bucket 是否匹配、Bucket 名称拼写、AccessKey 是否有该桶的写权限(PutObject)、密钥是否已过期或被禁用。错误信息中会包含存储服务返回的具体原因。

为什么返回的链接带一长串签名参数? 未配置「公开访问域名」时,桶按私有读处理,平台会生成带签名的链接。配置公开访问域名(公共读 Bucket 或 CDN 域名)后即为干净的永久直链。

开启后历史任务的链接会变吗? 不会。转存只对开启后新完成的任务生效,历史任务仍是原链接。

只想转存视频、不想转存图片可以吗? 目前是统一开关,开启后视频与图片结果都会转存到你的桶。

本页目录