API ReferenciaGestión de voz
Lista de voces
Enumere las voces públicas y personales disponibles para la clave API actual.
Lista de voces
GET /api/open/v1/voicesURL completa:
https://fishaudio.org/api/open/v1/voicesencabezados
Authorization: Bearer FISHAUDIO_API_KEYListar voces es de solo lectura. No crea tareas ni consume créditos.
Opciones de consulta
El punto final lee filtros opcionales de los parámetros de consulta de URL. Si los omite, API devuelve la primera página de voces públicas.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
page | entero | No | Número de página. Valor predeterminado: 1 |
pageSize | entero | No | Artículos por página. Valor predeterminado: 20, máximo: 100 |
modelType | cadena | No | public, personal o all |
includePersonal | booleano | No | Cuando true, el tipo de modelo predeterminado pasa a ser all |
Respuesta
{
"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
}
]
}Utilice items[].voiceId en solicitudes TTS.
Voz de prueba rápida
Para probar TTS antes de elegir una voz de la respuesta, utilice esta identificación de voz del sistema público:
00a1b221-6137-4b73-ad62-b0cbce134167Reemplácelo con un valor items[].voiceId cuando esté listo para seleccionar una voz de producción.
Ejemplo curl
curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Errores
| Estado | Significado |
|---|---|
401 | Falta la clave API o no es válida |
403 | La cuenta no puede enumerar voces |
500 | Error en la consulta del catálogo de voz |