Get Asset

GET/v1/assets/{assetId}

Get an asset.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Path Parameters

assetIdstringrequired

Asset ID.

Response

codeinteger

Response status code.

dataobject

Asset detail object.

data.idinteger

Internal asset ID.

data.assetIdstring

Asset public ID.

data.token360AssetIdstring

Backward-compatible alias of assetId.

data.tenantIdinteger

Tenant ID.

data.userIdinteger

Owner user ID.

data.userNamestring

Owner display name.

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

Provider-level error details, if any.

data.namestring

Display name.

data.filenamestring

Original filename.

data.mimeTypestring

MIME type.

data.sizeBytesinteger

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.byteplusAssetIdstring

Provider identifier for BYTEPLUS assets.

data.providerRefsobject

Provider references by kind.

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": 0,
3  "data": {
4    "assetId": "asset_123",
5    "name": "avatar.png",
6    "mediaType": "image"
7  },
8  "msg": "OK"
9}

Was this page helpful?