Get a file (re-mints a fresh 1h signed URL)
Returns the file metadata plus a freshly-minted 1h signed URL. Use this to re-mint a download URL whenever the previous one expires.
Authorizations
Your team API key (starts with al_live_).
Headers
Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-07-16 for unauthenticated requests.
^\d{4}-\d{2}-\d{2}$"2026-07-16"
Path Parameters
Opaque file ID.
"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"
Response
File found
Opaque file ID.
"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"
Object discriminator.
"file"
How the file is used downstream. Image purposes: reference, first_frame, last_frame. Media purposes (PR-4): reference_video / reference_audio for the /v1/videos BYO reference fields.
reference, first_frame, last_frame, reference_video, reference_audio "reference"
image/png, image/jpeg, image/webp, video/mp4, video/quicktime, audio/mpeg, audio/wav "image/jpeg"
File size in bytes.
1247892
Decoded image width in pixels (max 4096).
1024
Decoded image height in pixels (max 4096).
768
Time-limited signed URL valid for ~1h. Re-mint a fresh URL by re-fetching GET /v1/files/:id. Do NOT cache long-term — the underlying bucket is private.
"https://...?token=..."
Hard 24h TTL — the file is automatically purged at this timestamp.
"2026-05-04T14:00:00Z"
Creation timestamp.
"2026-05-03T14:00:00Z"
Clip duration in seconds — populated for media uploads (reference_video / reference_audio, parsed at upload time), null for images.
7.4
Echoed metadata.

