Voix et clonage
Listez les profils vocaux, préréglages des moteurs et capacités de clonage.
GET /v1/audio/voices relie la bibliothèque de voix VoiceStudio aux clients compatibles OpenAI.
curl "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY"La réponse contient deux listes :
voices: alias OpenAI et profils enregistrés.engines: moteurs TTS installés, avec prise en charge du clonage, routage des appareils et indications de configuration.
Listez uniquement vos profils :
curl -s "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
| jq '.voices[] | select(.type == "profile") | {voice_id, name, language}'Passez directement un voice_id à la synthèse vocale :
{
"model": "tts-1",
"voice": "demo0001",
"input": "This line uses a saved VoiceStudio profile."
}Valeurs acceptées par voice
| Valeur | Résultat |
|---|---|
default | Voix par défaut du moteur sélectionné |
alloy, echo, fable, nova, onyx, shimmer | Acceptés pour compatibilité ; associés au défaut du moteur |
| Un ID de profil | Audio de référence, transcription, style et graine enregistrés |
| Un préréglage de moteur | Transmis aux moteurs disposant de voix nommées |
Créez, verrouillez, importez et exportez les profils et gérez leur consentement avec /profiles/* et /personas/*, documentés dans la référence API.
ID locaux
Les ID de profil présentés ici appartiennent à l’application de bureau. Le contrat Cloud non publié utilise des ressources Voice appartenant au tenant ; un ID local ou un corps de requête ne s’y transpose pas sans modification.