跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

转为持久存储

POST /v1/storages/promote

将一个或多个临时产物转为持久，使其长期保存、不再约 7 天后过期。持久存储按大小计费。转持久为异步操作，采用部分成功语义。

请求头

Section titled “请求头”
Authorization Bearer YOUR_API_KEY 必填

账号 API Key，所有请求必填。

Content-Type application/json 必填

请求体为 JSON。

请求体

Section titled “请求体”

一个产物 id 的 JSON 数组——取自获取历史产物列表，以字符串形式传入。单批最多 50 个。

Terminal window
curl -X POST "https://api.hiapi.ai/v1/storages/promote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '["90216", "90215"]'

响应

Section titled “响应”
{
  "code": 200,
  "message": "success",
  "data": {
    "accepted": ["90216"],
    "rejected": [
      { "id": "90215", "reason": "cap_exceeded" }
    ]
  }
}
  • accepted —— 已进入转持久队列的 id。转持久在后台执行；产物路径不变，处理完成后切换到持久 CDN 域名。可轮询获取历史产物列表，直到 storage_tier 变为 persistent。
  • rejected —— 未能转持久的 id，每项附带原因。

拒绝原因

Section titled “拒绝原因”
reason含义
not_owned该账号下不存在此产物。
insufficient账号余额 ≤ 0。整批被拒——充值后重试。
cap_exceeded转持久会超出持久存储上限。请先清理或联系我们扩容。
not_promotable不是已完成的临时产物（已是持久、仍在生成、或已失败）。
already_deleted产物已被删除。
storage_op_pending该产物已有进行中的存储操作——请稍后重试。