Référence APIGestion de la voix
Liste des voix
Répertoriez les voix publiques et personnelles disponibles pour la clé API actuelle.
Liste des voix
GET /api/open/v1/voicesURL complète :
https://fishaudio.org/api/open/v1/voicesEn-têtes
Authorization: Bearer FISHAUDIO_API_KEYLa liste des voix est en lecture seule. Il ne crée pas de tâches et ne consomme pas de crédits.
## Options de requête
Le point de terminaison lit les filtres facultatifs à partir des paramètres de requête d'URL. Si vous les omettez, le API renvoie la première page des voix publiques.
| Champ | Tapez | Obligatoire | Descriptif |
|---|---|---|---|
page | entier | Non | Numéro de page. Par défaut : 1 |
pageSize | entier | Non | Articles par page. Par défaut : 20, maximum : 100 |
modelType | chaîne | Non | public, personal ou all |
includePersonal | booléen | Non | Lorsque true, le type de modèle par défaut devient all |
Réponse
{
"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
}
]
}Utilisez items[].voiceId dans les requêtes TTS.
Voix de test rapide
Pour tester TTS avant de choisir une voix dans la réponse, utilisez cet ID vocal du système public :
00a1b221-6137-4b73-ad62-b0cbce134167Remplacez-le par une valeur items[].voiceId lorsque vous êtes prêt à sélectionner une voix de production.
curl Exemple
curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Erreurs
| Statut | Signification |
|---|---|
401 | La clé API est manquante ou invalide |
403 | Le compte ne peut pas répertorier les voix |
500 | Échec de la requête du catalogue vocal |