获取历史产物列表

GET /v1/storages

返回当前账号的历史产物——临时与持久——按创建时间倒序排列。已删除产物不包含在内。

请求头

Authorization Bearer YOUR_API_KEY 必填

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

查询参数

</> 生成代码

type string 可选

按档位筛选：temp、persistent 或 all。

默认 all

page int 可选

页码，>= 1。

默认 1

size int 可选

每页条数，1 ≤ size ≤ 100。

默认 10

服务端归一化：page 小于 1 取 1；size 小于 1 取 10，大于 100 取 100。

响应

{
  "code": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "id": 90217,
        "task_id": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
        "artifact_type": "image",
        "storage_tier": "persistent",
        "cdn_url": "https://<persistent-cdn-domain>/abcd123456/01HZTQ8BX2-0.png",
        "size_bytes": 1843204,
        "expire_at": 0,
        "promotable": false,
        "created_at": 1777282099
      },
      {
        "id": 90216,
        "task_id": "tk-hiapi-01HZTQ5M0J9W8C2B6N4P1S3D7F",
        "artifact_type": "video",
        "storage_tier": "temporary",
        "cdn_url": "https://cdn.hiapi.ai/abcd123456/01HZTQ5M0J-0.mp4",
        "size_bytes": 8421765,
        "expire_at": 1777886899,
        "promotable": true,
        "created_at": 1777282010
      }
    ],
    "total": 42,
    "page": 1,
    "size": 20
  }
}

单项字段

id int 可选

产物 id。转持久 / 删除时以字符串形式传入。

task_id string 可选

产出该产物的 /v1/tasks 任务。

artifact_type string 可选

产物类型，如 image、video、audio、first_frame、thumbnail。

storage_tier string 可选

temporary 或 persistent。

cdn_url string 可选

公开下载地址。临时与持久产物使用不同的 CDN 域名；转持久会保留路径、切换域名。

size_bytes int 可选

存储大小（字节）。持久存储按此计费。

expire_at int 可选

临时产物被删除的 Unix 秒；持久产物为 0（不过期）。

promotable bool 可选

该产物是否可转为持久。

created_at int 可选

产物创建的 Unix 秒。

用 id 转持久和删除

把每个产物的 id 以字符串形式放进转持久和删除的请求数组里。