Stimmen auflisten

Listet öffentliche und persönliche Stimmen auf, die für den aktuellen API-Schlüssel verfügbar sind.

GET /api/open/v1/voices

Vollständige URL:

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

Kopfzeilen

Authorization: Bearer FISHAUDIO_API_KEY

Das Auflisten von Stimmen ist schreibgeschützt. Es werden keine Aufgaben erstellt und keine Credits verbraucht.

Abfrageoptionen

Der Endpunkt liest optionale Filter aus URL-Abfrageparametern. Wenn Sie sie weglassen, gibt API die erste Seite der öffentlichen Stimmen zurück.

Feld	Geben Sie	ein Erforderlich	Beschreibung
`page`	Ganzzahl	Nein	Seitenzahl. Standard: `1`
`pageSize`	Ganzzahl	Nein	Artikel pro Seite. Standard: `20`, Maximum: `100`
`modelType`	Zeichenfolge	Nein	`public`, `personal` oder `all`
`includePersonal`	boolescher Wert	Nein	Bei `true` lautet der Standardmodelltyp `all`
`language`	Zeichenfolge	Nein	Exakter Code der Hauptsprache, etwa `zh` oder `en`
`supportsLanguage`	Zeichenfolge	Nein	Filtert Stimmen mit Unterstützung für diesen Sprachcode
`search`	Zeichenfolge	Nein	Sucht ohne Beachtung der Groß-/Kleinschreibung in Name oder Beschreibung

Antwort

{
  "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
    }
  ]
}

Verwenden Sie items[].voiceId in TTS-Anfragen.

Schneller Sprachtest

Um TTS zu testen, bevor Sie eine Stimme aus der Antwort auswählen, verwenden Sie diese Sprach-ID des öffentlichen Systems:

00a1b221-6137-4b73-ad62-b0cbce134167

Ersetzen Sie ihn durch einen items[].voiceId-Wert, wenn Sie bereit sind, eine Produktionsstimme auszuwählen.

curl Beispiel

curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

Fehler

Status	Bedeutung
`401`	API-Schlüssel fehlt oder ist ungültig
`403`	Das Konto kann keine Stimmen auflisten
`500`	Abfrage des Sprachkatalogs fehlgeschlagen

Anfragevorschau

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