API ReferenceVoice Management
List Voices
List public and personal voices available to the current API key.
CN API paths use a separate contract
This English reference describes the global FishAudio Open API. For Kitta Audio China integrations, use the CN API Reference, API Playground, and API Keys in this site.
List Voices
GET /api/open/v1/voicesFull URL:
https://fishaudio.org/api/open/v1/voicesHeaders
Authorization: Bearer FISHAUDIO_API_KEYListing voices is read-only. It does not create tasks or consume credits.
Query Options
The endpoint reads optional filters from URL query parameters. If you omit them, the API returns the first page of public voices.
| Field | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number. Default: 1 |
pageSize | integer | No | Items per page. Default: 20, maximum: 100 |
modelType | string | No | public, personal, or all |
includePersonal | boolean | No | When true, the default model type becomes all |
Response
{
"total": 1,
"page": 1,
"pageSize": 20,
"totalPages": 1,
"items": [
{
"voiceId": "voice_123",
"title": "Clara",
"description": "",
"created_at": "2026-07-09T00:00:00.000Z",
"updated_at": "2026-07-09T00:00:00.000Z",
"isPersonal": false
}
]
}Use items[].voiceId in TTS requests.
curl Example
curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Errors
| Status | Meaning |
|---|---|
401 | API key is missing or invalid |
403 | Account cannot list voices |
500 | Voice catalog query failed |
Continue with runnable API checks
Docs and executable requests stay in the same CN-site surface. After reading the reference, open the API Playground for curl examples or manage API keys in the developer workspace.