---
title: "Get Seedance material asset"
method: GET
path: "/v1/videos/assets/{assetId}"
tags: ["Video"]
---

# Get Seedance material asset

`GET /v1/videos/assets/{assetId}`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/videos/assets/{assetId}`
- Auth: HTTP bearer

Retrieves one TokenLab Seedance material asset and its asynchronous ingestion status.

## Path parameters

- `assetId` string, required

## Query parameters

- `project_name` string

## Response `200`

Material asset

- SeedanceMaterialAsset
  - `id` string, required: TokenLab material asset ID. Use this as material_asset_id after the asset becomes ACTIVE.
  - `object` 'seedance.material_asset', required
  - `group_id` string, nullable: TokenLab material group ID that owns this material asset.
  - `project_name` string: Project scope for this material asset.
  - `library_type` 'aigc_avatar' | 'liveness_face', required
  - `asset_name` string, nullable
  - `asset_type` 'Image' | 'Video' | 'Audio', required
  - `status` 'PROCESSING' | 'ACTIVE' | 'FAILED' | 'DELETED', required
  - `ready` boolean, required: True when the asset is active and not deleted.
  - `error_message` string, nullable: Public-safe terminal processing error. Permanent source validation failures include the rejected dimension constraint.
  - `metadata` object, nullable
  - `created_at` integer: Unix timestamp when the material asset record was created.
  - `updated_at` integer: Unix timestamp when the material asset record was last updated.

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Material library unavailable

---

[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)
