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

# 资产概览

> API 侧素材与音色

Open API **资产**是你在任务请求中通过 ID 引用的资源。两类：

| 资产               | ID 字段        | 用途                                                                    |
| ---------------- | ------------ | --------------------------------------------------------------------- |
| **素材（Material）** | `materialId` | 音视频输入（主要用于媒体翻译）。须走完完整 [上传](/zh/guides/assets/material-upload) 流程后方可使用 |
| **音色（Voice）**    | `voiceId`    | 系统预设或克隆音色，用于 TTS                                                      |

## 仅 API 侧存储

通过 API 上传或创建的素材、音色，与你在 [vmeg.ai](https://www.vmeg.ai/home) 网页上管理的文件、音色不互通，不能混用 `materialId` / `voiceId`。请仅用 `/openapi/v1/assets/**` 管理。API 任务同样独立，见 [产品概览](/zh/guides/products/overview)。

列表与删除等操作仅返回当前 **API Key** 下的资产；音色列表接口同样按 Key 限定范围。

## 典型流程

```text theme={null}
完整素材上传 → 已注册 materialId → 媒体翻译任务
声音克隆 → voiceId → TTS 任务
查询系统音色 → voiceId → TTS 任务
```

## 指南

<CardGroup cols={2}>
  <Card title="素材" icon="photo-film" href="/zh/guides/assets/materials">
    类型、列表与删除
  </Card>

  <Card title="素材上传" icon="cloud-arrow-up" href="/zh/guides/assets/material-upload">
    预签名与分片上传
  </Card>

  <Card title="音色" icon="waveform-lines" href="/zh/guides/assets/voices">
    系统音色与克隆音色
  </Card>
</CardGroup>

请求与响应字段：见 [API 参考](/zh/api-reference/introduction) 中 [Assets - Materials](/api-reference/assets/materials/list-materials) 与 [Assets - Voices](/api-reference/assets/voices/list-system-voices)。