> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vmeg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 素材

> Open API 音视频资产

## 什么是素材

**素材**是已注册的音视频文件，供 Open API 任务引用。走完完整的 [素材上传](/zh/guides/assets/material-upload) 流程后，你才会得到可用于建任务的 **`materialId`**，例如 [音视频翻译](/zh/guides/products/media-translation)。

不要使用未完成上传时返回的 `materialId`（例如仅 gen-upload-url 或分片发起）。素材仅属 API 侧，与 vmeg.ai 网页上传的文件不互通。见 [资产概览](/zh/guides/assets/overview)。

## 素材类型

字段 `category` 表示资产类型，例如：

| `category` | 典型用途                 |
| ---------- | -------------------- |
| `video`    | 视频翻译（`taskType: vt`） |
| `audio`    | 音频翻译（`taskType: at`） |

其他字段包括 `name`、CDN 地址（`addressUrl`、`thumbnailUrl`、`audioUrl`）、`mimeType`、`duration`、`filesize` 等。完整字段说明见 [列表查询](/api-reference/assets/materials/list-materials) 的响应体。

## 生命周期

1. 走完完整 [上传](/zh/guides/assets/material-upload) 流程 → 已注册的 `materialId`
2. 在产品请求中引用该 `materialId`
3. 不需要时 **列表查询** 或 **删除**

## 操作

| 操作 | 接口                                        |
| -- | ----------------------------------------- |
| 列表 | `GET /openapi/v1/assets/material/list`    |
| 删除 | `POST /openapi/v1/assets/material/delete` |

上传流程见 [素材上传](/zh/guides/assets/material-upload)。

请求与响应字段：[列表查询](/api-reference/assets/materials/list-materials)、[删除素材](/api-reference/assets/materials/delete-material)，以及 [API 参考](/zh/api-reference/introduction) 中 **Assets - Materials** 下的其他接口。