---
title: "Retrieve Media Asset"
method: GET
path: "/media/{id}"
tags: ["Media"]
---

# Retrieve Media Asset

`GET /media/{id}`

Retrieves a media asset by ID. Poll this while the asset is `processing`.

## Path parameters

- `id` string, required

## Response `200`

Media asset retrieved.

- MediaAsset
  - `amount_charged` number, nullable, required — USD amount charged to the account's balance for this generation. `null` if the generation wasn't billed.
  - `completed_at` string, nullable, required — ISO 8601 timestamp when the asset reached a terminal state. `null` while `processing`.
  - `created_at` string, required — ISO 8601 timestamp when the generation was requested.
  - `currency` string, required — Currency of `amount_charged`. Always `usd`.
  - `error_message` string, nullable, required — Why generation failed. `null` unless status is `failed`.
  - `file` MediaAssetFile, required
    - `id` string, required — File ID, prefixed `file_`.
    - `url` string, required — CDN URL for downloading the file.
  - `generation` MediaAssetGeneration, required
    - `duration_seconds` number, nullable, required — Requested video length in seconds. `null` for images.
    - `prompt` string, required — What the asset was generated from.
    - `reference_media` string[], required
    - `resolution` '480p' | '720p' | '1080p' | '4k' | 'null', nullable, required — Requested video resolution. `null` for images. `1080p` is not supported by Seedance 2.0 Fast or Mini; `4k` is only supported by Seedance 2.0.
  - `id` string, required — Media asset ID, prefixed `media_`.
  - `media_type` 'video' | 'image', required — The kind of media this asset holds.
  - `source` 'generated', required — How the asset was created. Always `generated`.
  - `status` 'processing' | 'ready' | 'failed', required — Lifecycle state: `processing` while generation runs, `ready` when the file is available, `failed` when generation failed and the charge was refunded.

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)