Kitta Audio Docs
Référence APIGestion de la voix
Back to site

Clonage de voix

Téléchargez un audio de référence et créez une voix personnalisée.

Clonage de voix

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

URL complète :

https://kittaai.com/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

ChampTapezObligatoireDescriptif
namechaîneOuiNom de la voix
audioFilesfichier[]OuiUn ou plusieurs fichiers audio de référence
descriptionchaîneNonDescription vocale
referenceTextchaîneNonTranscription de l'audio de référence
visibilitychaîneNonprivate ou public. Par défaut : private
languageschaîneNonTableau 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.

curl Exemple

curl -X POST "https://kittaai.com/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

StatutSignification
400Champs manquants, type de fichier non pris en charge ou fichier surdimensionné
401La clé API est manquante ou invalide
403Le compte ne peut pas créer de voix
429Les demandes de création de voix sont trop fréquentes
500La 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.