List Stored Outputs

GET /v1/storages

Returns the current account’s stored outputs — temporary and persistent — ordered by creation time, newest first. Deleted outputs are excluded.

Headers

Authorization Bearer YOUR_API_KEY required

Account API key. Required on every request.

Query parameters

GET https://api.hiapi.ai/v1/storages?type=all&page=1&size=20

# Send the request and return the JSON result
# Replace YOUR_API_KEY with your account API key
curl -X GET "https://api.hiapi.ai/v1/storages?type=all&page=1&size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

# Send the request and return the JSON result
# Replace YOUR_API_KEY with your account API key
resp = requests.get(
    "https://api.hiapi.ai/v1/storages?type=all&page=1&size=20",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.json())  # Print the returned JSON

// Send the request and return the JSON result
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/storages?type=all&page=1&size=20", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await resp.json()); // Print the returned JSON

type string optional

Filter by tier: temp, persistent, or all.

default all

page int optional

Page number, >= 1.

default 1

size int optional

Items per page, 1 ≤ size ≤ 100.

default 10

Server-side normalization: page below 1 becomes 1; size below 1 becomes 10, and anything above 100 is capped at 100.

Response

{
  "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
  }
}

Item fields

id int optional

Output id. Pass it as a string to promote / delete.

task_id string optional

The /v1/tasks task that produced this output.

artifact_type string optional

Kind of output, e.g. image, video, audio, first_frame, thumbnail.

storage_tier string optional

temporary or persistent.

cdn_url string optional

Public download URL. Temporary and persistent outputs are served from different CDN domains; a promote keeps the path and switches the host.

size_bytes int optional

Stored size in bytes. Persistent storage is billed on this.

expire_at int optional

Unix seconds when a temporary output is deleted; 0 for persistent outputs (no expiry).

promotable bool optional

Whether this output can be promoted to persistent.

created_at int optional

Unix seconds when the output was created.