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-dataVollständige URL:
https://fishaudio.org/api/open/v1/voicesBei 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
| Feld | Geben Sie | ein Erforderlich | Beschreibung |
|---|---|---|---|
name | Zeichenfolge | Ja | Sprachname |
audioFiles | Datei[] | Ja | Eine oder mehrere Referenz-Audiodateien |
description | Zeichenfolge | Nein | Sprachbeschreibung |
referenceText | Zeichenfolge | Nein | Transkript für das Referenzaudio |
visibility | Zeichenfolge | Nein | private oder public. Standard: private |
languages | Zeichenfolge | Nein | JSON-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
| Status | Bedeutung |
|---|---|
400 | Fehlende Felder, nicht unterstützter Dateityp oder übergroße Datei |
401 | API-Schlüssel fehlt oder ist ungültig |
403 | Konto kann keine Stimmen erstellen |
429 | Anfragen zur Spracherstellung kommen zu häufig |
500 | Die 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.