---
title: "Get Asset"
method: GET
path: "/v1/assets/{asset_id}"
tags: ["Public API"]
---

# Get Asset

`GET /v1/assets/{asset_id}`

## Request

- Base URL: `https://api.animgen.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.animgen.com/v1/assets/{asset_id}`
- Auth: HTTP bearer

## Path parameters

- `asset_id` string, uuid, required

## Response `200`

Successful Response

- AssetResponse
  - `object` 'asset'
  - `id` string, uuid, required: Stable public asset ID; use it to refresh download metadata.
  - `format` string, required: Artifact format; inspect actual outputs rather than assuming an array order.
  - `mime_type` string, required: Asset media type.
  - `byte_size` integer, required: Expected file size in bytes.
  - `created_at` string, date-time, required: Creation timestamp in UTC.
  - `download_url` string, required: Sensitive short-lived signed URL. Download without a Bearer header, including after redirects; never log the URL.
  - `download_expires_at` string, date-time, required: Signed URL expiry in UTC; refresh via asset lookup when expired.
  - `media` object, nullable: Whitelisted measured video metadata. Unknown fields are null; non-video assets return null.
    - `duration_seconds` number, nullable: Playable video duration measured from presentation timestamps; never provider-requested duration.
    - `fps` number, nullable: Measured average source frame rate; use presentation timestamps for VFR selection.
    - `frame_count` integer, nullable: Decoded source frame count, or null when unknown.
    - `width` integer, nullable: Displayed video width in pixels, accounting for rotation.
    - `height` integer, nullable: Displayed video height in pixels, accounting for rotation.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/animgen/apis/aianimgenbackend.md) · [All operations](https://skmtc.dev/animgen/apis/aianimgenbackend/llms.txt) · [OpenAPI document](https://skmtc.dev/animgen/apis/aianimgenbackend/revisions/0504d838139a?raw)
