Liste des voix

Répertoriez les voix publiques et personnelles disponibles pour la clé API actuelle.

GET /api/open/v1/voices

URL complète :

https://fishaudio.org/api/open/v1/voices

En-têtes

Authorization: Bearer FISHAUDIO_API_KEY

La 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`
`language`	chaîne	Non	Correspondance exacte de la langue principale, comme `zh` ou `en`
`supportsLanguage`	chaîne	Non	Filtre les voix prenant en charge le code de langue indiqué
`search`	chaîne	Non	Recherche le nom ou la description sans tenir compte de la casse

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-b0cbce134167

Remplacez-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

Aperçu de la requête

GET https://fishaudio.org/api/open/v1/voices?modelType=all&includePersonal=true&page=1&pageSize=20
Authorization: Bearer YOUR_API_KEY