Clonage de voix

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

URL complète :

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

La création vocale utilise l'audio de référence et le flux de création FishAudio. La route Open API ignore les remplacements du fournisseur, vous n'avez donc pas besoin d'envoyer un champ provider.

Champs de requête

Champ	Tapez	Obligatoire	Descriptif
`name`	chaîne	Oui	Nom de la voix
`audioFiles`	fichier[]	Oui	Un ou plusieurs fichiers audio de référence
`description`	chaîne	Non	Description vocale
`referenceText`	chaîne	Non	Transcription de l'audio de référence
`visibility`	chaîne	Non	`private` ou `public`. Par défaut : `private`
`languages`	chaîne	Non	Tableau de chaînes JSON, tel que `'["zh","en"]'`

Extensions de fichiers prises en charge : aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav et webm. Chaque fichier peut aller jusqu'à 10MB.

Ne définissez pas manuellement la limite en plusieurs parties. Lorsque vous utilisez curl -F, le navigateur FormData ou un SDK, laissez le client générer Content-Type.

Tester l’API de création de voix

Aperçu de la requête

POST https://fishaudio.org/api/open/v1/voices
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

name: <required>
description: <optional>
referenceText: <optional>
visibility: private
languages: <optional JSON array>
audioFiles: <required>

curl Exemple

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"

Réponse

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

Stockez le voiceId renvoyé, puis transmettez-le directement lors de la génération de la parole.

Erreurs

Statut	Signification
`400`	Champs manquants, type de fichier non pris en charge ou fichier surdimensionné
`401`	La clé API est manquante ou invalide
`403`	Le compte ne peut pas créer de voix
`429`	Les demandes de création de voix sont trop fréquentes
`500`	La création de voix a échoué sur le serveur

La création d'une voix enregistre l'utilisation d'Open API et est soumise au quota Open API du compte actuel et à l'allocation du fournisseur.