介绍
你用 HiAPI 生成的每个产物——图像、音频、视频，无论通过 API 还是官网——都由 HiAPI 的 CDN 提供，并以 cdn_url 返回。默认情况下产物为临时，生成约 7 天后过期。产物存储让你用 API Key 把选中的产物长期保存并加以管理。下载始终免费。
| 档位 | 默认 | 保留时长 | 存储计费 |
|---|---|---|---|
| temp | 是 | 生成约 7 天后自动删除 | 免费 |
| persistent | 否 | 长期保存，直到你删除 | 按存储大小计费 |
让产物长期保存
Section titled “让产物长期保存”这是按产物的模型——你逐个决定要保留哪些产物。两种方式：
- 创建时定档——在创建任务时传
"storage": "persistent"，产物直接写入长期存储。 - 事后升级——在临时产物过期前随时转持久。也可以在控制台管理：控制台 → 存储（产物存储管理）列出全部产物，提供临时 / 持久筛选与逐项转持久 / 删除。
要停止为某个持久产物付费，请删除它——没有”降级”。
所有接口都用 API Key 鉴权（Authorization: Bearer YOUR_API_KEY），且只作用于调用账号自己的产物。
| 项目 | 说明 |
|---|---|
| 单价 | $0.05 / GB · 月 |
| 结算周期 | 每天 UTC 00:30 扣一次。当天扣费 = 存储大小 × $0.05 ÷ 30 |
| 下载流量 | 免费——不限下载、不计量 |
| 写操作 | 对用户免费——CDN PUT / 操作费由 HiAPI 承担 |
| 你存了 | 每月 | 每天 |
|---|---|---|
| 5 GB | $0.25 | $0.0083 |
| 50 GB | $2.50 | $0.083 |
| 100 GB（上限） | $5.00 | $0.167 |
删除立即省钱：今天删一半，明天的账单就少一半。只为你存着的、存着的时间付费。
限制与生命周期
Section titled “限制与生命周期”- 账号级上限：默认 100 GB（可按账号分组配置）。转持久超出上限会以
cap_exceeded拒绝；创建任务传"storage": "persistent"超出上限则静默降级为临时——生成照常成功。需要更大容量请联系我们。
持久化存储每天从你的余额扣费。
- 若余额连续 3 天无法覆盖扣费，相关产物进入 7 天宽限期，并发送提醒邮件。
- 随时充值即可恢复——宽限期立即清除，产物保留。
- 宽限期过后，产物会被删除。
- 产物 URL 是公开的，但路径含不可猜测的随机串——外部无法枚举或猜出你的文件。
- 拿到 URL 的任何人都能下载（方便分享或嵌入你的产品）。
- 暂不提供签名 / 私有 URL 选项。有需求请联系我们。
和你调 API 用的是同一个余额。$0.05/GB·月 从你的充值余额里扣。
视频也算吗？
Section titled “视频也算吗？”算。所有 HiAPI 生成的图片和视频都计入持久化存储用量。视频可能很大——注意账单。
产物 URL 是公开的吗？
Section titled “产物 URL 是公开的吗？”是的——URL 公开，但路径是不可猜测的随机串。拿到 URL 的人都能下载。不想被别人访问的 URL 不要分享。
100 GB 不够怎么办？
Section titled “100 GB 不够怎么办？”超出上限后，新的持久写入会回落到 7 天过期（生成仍然正常）。可删除较旧的产物腾空间，或联系我们扩容。