# 可用音色

> `GET /voices`　|　文档 4/7｜更新于 2026-09-26｜[返回索引](https://ai.aibobos.com/openapi/index.md)

列出当前账号可用的音色（公共音色 + 自己克隆的），并给出默认音色。

**为什么 Agent 需要它**：Agent 不必让人先挑音色——不传 `voice_id` 时服务端会自动取列表第一个。

## 调用

```bash
curl -s "https://ai.aibobos.com/api/openapi/v1/voices" \
  -H "Authorization: Bearer $AIBO_KEY"
```

## 响应

```json
{
  "object": "list",
  "data": [
    {"voice_id": "vox_demo_public", "name": "演示公共音色", "gender": "female", "language": "zh", "source": "public"}
  ],
  "default": "vox_demo_public"
}
```

## 注意

- 过滤掉了排队中 / 克隆中的音色（`usable=0`）—— 列表里有的一定能用。
- `source`：`public` 公共音色，`clone` 声音复刻。

---

- 鉴权：`Authorization: Bearer <API Key>`；需要 `tts` 能力域
- 计费：见[索引页的计费表](https://ai.aibobos.com/openapi/index.md#计费口径)，失败自动退回
- 机器可读描述：[openapi.json](https://ai.aibobos.com/openapi.json)