API ReferenceVoice Management
List Voices
List public and personal voices available to the current API key.
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 |