Vozes e clonagem
Liste perfis de voz, predefinições de mecanismos e suporte à clonagem.
GET /v1/audio/voices conecta a biblioteca de vozes do VoiceStudio a clientes compatíveis com OpenAI.
curl "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY"A resposta contém duas listas:
voices: aliases OpenAI e seus perfis salvos.engines: mecanismos TTS instalados, com suporte à clonagem, roteamento de dispositivo e dicas de configuração.
Liste apenas seus perfis:
curl -s "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
| jq '.voices[] | select(.type == "profile") | {voice_id, name, language}'Passe um voice_id diretamente para a geração de fala:
{
"model": "tts-1",
"voice": "demo0001",
"input": "This line uses a saved VoiceStudio profile."
}O que voice aceita
| Valor | Resultado |
|---|---|
default | A voz padrão do mecanismo selecionado |
alloy, echo, fable, nova, onyx, shimmer | Aceitos por compatibilidade; mapeados para o padrão do mecanismo |
| ID de perfil | Áudio de referência, transcrição, estilo e semente salvos |
| Predefinição de mecanismo | Enviada aos mecanismos que incluem vozes nomeadas |
Crie, bloqueie, importe, exporte e gerencie o consentimento dos perfis pelas rotas /profiles/* e /personas/*, documentadas na referência da API.
IDs locais
Os IDs de perfil aqui pertencem ao aplicativo desktop. O contrato Cloud ainda não lançado usa recursos Voice pertencentes ao tenant; um ID de perfil local ou corpo de solicitação não será transferido sem alterações.