Fish Audio Docs
API ReferenzSprachverwaltung

Stimmklonen

Laden Sie Referenzaudio hoch und erstellen Sie eine benutzerdefinierte Stimme.

Stimmklonen

POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-data

Vollständige URL:

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

Bei der Spracherstellung werden Referenzaudio und der FishAudio-Erstellungsablauf verwendet. Die Open API-Route ignoriert Anbieterüberschreibungen, sodass Sie kein provider-Feld senden müssen.

Anforderungsfelder

FeldGeben Sieein ErforderlichBeschreibung
nameZeichenfolgeJaSprachname
audioFilesDatei[]JaEine oder mehrere Referenz-Audiodateien
descriptionZeichenfolgeNeinSprachbeschreibung
referenceTextZeichenfolgeNeinTranskript für das Referenzaudio
visibilityZeichenfolgeNeinprivate oder public. Standard: private
languagesZeichenfolgeNeinJSON-String-Array, z. B. '["zh","en"]'

Unterstützte Dateierweiterungen: aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav und webm. Jede Datei kann bis zu 10MB groß sein.

Legen Sie die Multipart-Grenze nicht manuell fest. Wenn Sie curl -F, den Browser FormData oder einen SDK verwenden, lassen Sie den Client Content-Type generieren.

curl Beispiel

curl -X POST "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -F "name=My cloned voice" \
  -F "description=Chinese narration voice" \
  -F "visibility=private" \
  -F 'languages=["zh"]' \
  -F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
  -F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"

Antwort

{
  "voiceId": "voice_abc123",
  "title": "My cloned voice",
  "description": "Chinese narration voice",
  "createdAt": "2026-07-09T00:00:00.000Z"
}

Speichern Sie den zurückgegebenen voiceId und übergeben Sie ihn dann direkt bei der Sprachgenerierung.

Fehler

StatusBedeutung
400Fehlende Felder, nicht unterstützter Dateityp oder übergroße Datei
401API-Schlüssel fehlt oder ist ungültig
403Konto kann keine Stimmen erstellen
429Anfragen zur Spracherstellung kommen zu häufig
500Die Spracherstellung ist auf dem Server fehlgeschlagen

Die Erstellung einer Sprachaufzeichnung erfolgt über die Open API-Nutzung und unterliegt dem Open API-Kontingent und der Anbieterzuteilung des aktuellen Kontos.