Voces y clonación
Lista perfiles de voz, ajustes de motores y compatibilidad con clonación.
GET /v1/audio/voices conecta la biblioteca de voces de VoiceStudio con clientes compatibles con OpenAI.
curl "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY"La respuesta contiene dos listas:
voices: alias de OpenAI y tus perfiles guardados.engines: motores TTS instalados, con soporte de clonación, asignación de dispositivos y consejos de configuración.
Lista solo tus perfiles:
curl -s "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
| jq '.voices[] | select(.type == "profile") | {voice_id, name, language}'Pasa un voice_id directamente a la generación de voz:
{
"model": "tts-1",
"voice": "demo0001",
"input": "This line uses a saved VoiceStudio profile."
}Qué acepta voice
| Valor | Resultado |
|---|---|
default | La voz predeterminada del motor seleccionado |
alloy, echo, fable, nova, onyx, shimmer | Aceptados por compatibilidad; asignados al valor predeterminado del motor |
| Un ID de perfil | Audio de referencia, transcripción, estilo y semilla guardados |
| Un ajuste del motor | Enviado a motores que incluyen voces con nombre |
Crea, bloquea, importa y exporta perfiles y gestiona el consentimiento mediante /profiles/* y /personas/*, documentados en la referencia de la API.
ID locales
Los ID de perfil aquí pertenecen a la aplicación de escritorio. El contrato Cloud no publicado usa recursos Voice del tenant; un ID de perfil local o cuerpo de solicitud no se traslada sin cambios.