# 获取素材详情

获取指定素材的详细信息，包括处理状态。仅可查看当前用户拥有的素材。

素材状态说明：
- **Active**：处理完成，可正常使用
- **Processing**：处理中，请稍后再查询（建议间隔 5 秒）
- **Failed**：处理失败，`Error` 字段包含错误信息

## GET /v1/assets/{assetId}

> 获取素材详情

获取指定素材的详细信息，包括处理状态。仅可查看当前用户拥有的素材。

素材状态说明：
- **Active**：处理完成，可正常使用
- **Processing**：处理中，请稍后再查询（建议间隔 5 秒）
- **Failed**：处理失败，`Error` 字段包含错误信息

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **assetId** `string` **(required)**  
  素材 ID

### Response

- **Id** `string`  
  素材 ID，可通过 `asset://<Id>` 格式在视频生成等接口中引用
- **Name** `string`  
  素材名称
- **AssetType** ``Image` | `Video` | `Audio``  
  素材类型
- **Status** ``Active` | `Processing` | `Failed``  
  素材处理状态：
- **GroupId** `string`  
  所属分组 ID
- **URL** `string`  
  素材文件 URL
- **CreateTime** `string`  
  创建时间
- **UpdateTime** `string`  
  最后更新时间
- **Error** `object`  
  错误信息，仅当 `Status: Failed` 时有值
- **Error.Code** `string`  
  错误码
- **Error.Message** `string`  
  错误描述

### Error Codes

- `401`: 
- `404`: 素材不存在或不属于当前用户
- `429`:
