---
title: "音色列表"
method: GET
path: "/paas/v4/voice/list"
tags: ["模型 API"]
---

# 音色列表

`GET /paas/v4/voice/list`

## Request

- Base URL: `https://open.bigmodel.cn/api`
- URL: `https://open.bigmodel.cn/api/paas/v4/voice/list`
- Auth: HTTP bearer

获取音色列表，支持按音色名称模糊搜索、按音色类型过滤。点击 **Try it** 按钮可快速试用。

## Query parameters

- `voiceName` string
- `voiceType` 'PRIVATE' | 'OFFICIAL'

## Response `200`

业务处理成功

- VoiceListResponse
  - `voice_list` VoiceVO[]: 音色列表
    - `voice` string: 音色
    - `voice_name` string: 音色名称
    - `voice_type` string: 音色类型，OFFICIAL为官方音色，PRIVATE为自定义音色
    - `download_url` string: 试听音频的下载链接
    - `create_time` string: 创建时间

## Other responses

- `default`: 请求失败。

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)