GET /asset

通过 ID 获取特定音频资产的完整元数据和标签信息。

请求

GET /asset?id=<assetId>

参数

参数	类型	描述
`id`	`number`	要获取的资产 ID

响应

返回一个包含所有嵌入元数据、物理属性、UCS 分类和标签的单个资产对象。

{
  "id": 12345,
  "fileName": "explosion_huge.wav",
  "format": "WAV",
  "duration": 5.4,
  "sampleRate": 48000,
  "channels": 2,
  "bitrate": 2304000,
  "bitDepth": 24,
  "fileSize": 3110400,
  "bpm": null,
  "title": "Huge Cinematic Explosion",
  "artist": "Sound Designer",
  "genre": "Cinematic",
  "comment": "Great for trailers",
  "albumTitle": null,
  "grouping": null,
  "additionalMetadata": "...",
  "dateAdded": "2026-04-18T10:30:00Z",
  "isFavorite": true,
  "ucsCatID": "EXPLReal",
  "ucsFxName": "Explosion Huge",
  "ucsCreatorID": "StudioX",
  "ucsSourceID": "Action Pack Y",
  "ucsUserCategory": null,
  "ucsVendorCategory": null,
  "ucsUserData": null,
  "tags": ["Action", "Sci-Fi", "Trailer"]
}

响应字段

字段	类型	描述
`id`	`number`	音频资产的唯一标识符
`fileName`	`string`	文件名
`format`	`string`	音频格式（如 `"WAV"`、`"FLAC"`）
`duration`	`number`	时长（秒）
`sampleRate`	`number`	采样率（Hz，如 `44100`、`48000`）
`channels`	`number`	声道数
`bitrate`	`number`	比特率（bps）
`bitDepth`	`number`	位深度（如 `16`、`24`），可选
`fileSize`	`number`	文件大小（字节）
`bpm`	`number \| null`	BPM（若已检测或嵌入），否则为 `null`
`title`	`string \| null`	标题元数据字段
`artist`	`string \| null`	艺术家元数据字段
`genre`	`string \| null`	流派元数据字段
`comment`	`string \| null`	评论 / 描述元数据字段
`albumTitle`	`string \| null`	专辑名称元数据字段
`grouping`	`string \| null`	分组元数据字段
`additionalMetadata`	`string \| null`	Base64 编码的额外原始 JSON 元数据字符串
`dateAdded`	`string`	文件添加到库中的 ISO 8601 时间戳
`isFavorite`	`boolean`	是否已标记为收藏
`ucsCatID`	`string \| null`	UCS 类别 ID
`ucsFxName`	`string \| null`	UCS FxName
`ucsCreatorID`	`string \| null`	UCS CreatorID
`ucsSourceID`	`string \| null`	UCS SourceID
`ucsUserCategory`	`string \| null`	UCS UserCategory
`ucsVendorCategory`	`string \| null`	UCS VendorCategory
`ucsUserData`	`string \| null`	UCS UserData
`tags`	`string[]`	已分配标签名称的数组