List Stored Outputs

GET Base URL: https://api.hiapi.ai /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. Any other value (e.g. bogus) is not an error — it falls back to 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,
        "duration_seconds": 0,
        "mime_type": "image/png",
        "media_kind": "image",
        "download_filename": "01HZTQ8BX2-0.png",
        "expire_at": 0,
        "promotable": false,
        "created_at": 1777282099,
        "prompt": "a cyan glass data center entrance"
      },
      {
        "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,
        "duration_seconds": 5,
        "mime_type": "video/mp4",
        "media_kind": "video",
        "download_filename": "01HZTQ5M0J-0.mp4",
        "expire_at": 1777886899,
        "promotable": true,
        "created_at": 1777282010,
        "prompt": "a cyan glass data center entrance"
      }
    ],
    "total": 42,
    "page": 1,
    "size": 20
  }
}

Item fields

id string optional

Output id. Use it in promote / delete request arrays.

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. The storage list only returns these two tiers; static outputs (built-in assets) are not listed. The task detail response calls the same setting storage (temp / persistent / static).

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. The old temporary URL stops working after the promote — fetch the item again to get the persistent URL.

size_bytes int optional

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

duration_seconds float optional

Media duration in seconds for outputs that have one, such as video and audio; 0 for still images.

mime_type string optional

MIME type of the stored file; application/octet-stream when the type is unknown.

media_kind string optional

Coarse presentation bucket: image, video, audio, caption, or file. Caption sidecars (subtitles) report caption.

download_filename string optional

Suggested filename when saving the file, derived from the stored object key.

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.

prompt string optional

The prompt of the task that produced this output. Empty for tasks with no text prompt, such as image-to-image edits, upscales, and audio tasks. This is the original user prompt, so treat it as private data — it is only returned for outputs owned by the calling account.