---
title: "Get a media result"
method: GET
path: "/v1/media-results/{id}"
tags: ["Media Results"]
---

# Get a media result

`GET /v1/media-results/{id}`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/media-results/{id}`
- Auth: none required

Returns a generated image, video, audio or downloadable 3D result. Result URLs have this form and stay valid for 30 days from when the result is first recorded. Use the URL exactly as you received it: its token grants access, and no API key is needed.

## Path parameters

- `id` string, required

## Query parameters

- `token` string, required
- `metadata` boolean

## Response `200`

The file, or the saving status when `metadata=true`.

- object
  - `status` 'saving' | 'saved' | 'failed' | 'expired', required
  - `expires_at` string, date-time, required
  - `content_type` string, nullable
  - `kind` 'image' | 'video' | 'audio' | '3d', required

## Other responses

- `302`: Redirect to a short-lived download URL for a saved image, video or audio file. The download URL lasts at most five minutes.
- `404`: `media_not_found`: the token or file extension does not match the result.
- `410`: `media_expired`: the 30-day period has ended, or saving failed more than 24 hours ago.
- `502`: `media_unavailable`: the result is not available now. Retry after the `Retry-After` delay.
- `503`: `media_unavailable`: the result is not available now. Retry after the `Retry-After` delay.

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)