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

# 音色列表

`GET /paas/v4/voice/list`

获取音色列表，支持按音色名称模糊搜索、按音色类型过滤。点击 **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.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)