Get Asset

GET/v1/assets/{assetId}

Get an asset.

Authentication

Authorization Bearer — JWT session or sk-* API key.

Path Parameters

assetIdstringrequired

Asset ID.

Response

codeinteger

Response status code.

dataobject

Asset detail object.

data.assetIdstring

Asset public ID.

data.sharedboolean

Whether the asset is shared with the caller.

data.sharePermissionstring

Share permission when shared.

data.shareExpiresAtstring

Share expiry time when shared.

data.assetGroupIdstring

Asset group public ID.

data.groupNamestring

Asset group name.

data.mediaTypestring

Image/video/audio.

data.assetKindstring

Asset kind.

data.sourceTypestring

Source type.

data.statusstring

Asset status.

data.providerLastErrorobject

Stable public error code and message, if available.

data.namestring

Display name.

data.filenamestring

Original filename.

data.mimeTypestring

MIME type.

data.sizeBytesstring

Asset size in bytes.

data.fileTypestring

File extension/format.

data.widthinteger

Width in pixels.

data.heightinteger

Height in pixels.

data.aspectRatiostring

Calculated aspect ratio.

data.durationSecondsnumber

Media duration in seconds.

data.frameRatenumber

Video frame rate.

data.urlstring

Accessible content URL.

data.thumbnailUrlstring

Thumbnail URL, if available.

data.expiresAtstring

Asset expiration timestamp.

data.requestIdstring

Request ID from asset generation provenance.

data.modelNamestring

Model name used to generate the asset.

data.modelTypestring

Model type used to generate the asset.

data.createdAtstring

Create timestamp.

data.updatedAtstring

Update timestamp.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.

Request

Shell

1curl https://api.token360.ai/v1/assets/{assetId} \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON

1{
2  "code": 200,
3  "data": {
4    "assetId": "ua_1234567890abcdef",
5    "name": "avatar.png",
6    "mediaType": "image"
7  },
8  "msg": "success"
9}

Managed asset quota and lifecycle

Virtual Portrait and Real Face uploads share the managed-asset quota for the current personal or tenant scope. Treat Get Asset Quota as the source of truth. The current default is 50,000 for a personal scope and 500,000 for a tenant scope; configured limits may differ.

Use only the public assetId and assetGroupId returned by Token360 in client integrations.

Was this page helpful?