Obter vozes disponíveis
curl --request GET \
--url https://suasofia.online/api/user/assistants/voices \
--header 'Authorization: Bearer <token>'import requests
url = "https://suasofia.online/api/user/assistants/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://suasofia.online/api/user/assistants/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://suasofia.online/api/user/assistants/voices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://suasofia.online/api/user/assistants/voices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://suasofia.online/api/user/assistants/voices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://suasofia.online/api/user/assistants/voices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": null
},
{
"id": 10,
"name": "Zephyr",
"language_id": 1,
"gender": "female",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
},
{
"id": 11,
"name": "Puck",
"language_id": 1,
"gender": "male",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
}
]
Assistentes
Obter vozes disponíveis
Recuperar todas as vozes disponíveis para configuração do assistente
GET
/
user
/
assistants
/
voices
Obter vozes disponíveis
curl --request GET \
--url https://suasofia.online/api/user/assistants/voices \
--header 'Authorization: Bearer <token>'import requests
url = "https://suasofia.online/api/user/assistants/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://suasofia.online/api/user/assistants/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://suasofia.online/api/user/assistants/voices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://suasofia.online/api/user/assistants/voices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://suasofia.online/api/user/assistants/voices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://suasofia.online/api/user/assistants/voices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": null
},
{
"id": 10,
"name": "Zephyr",
"language_id": 1,
"gender": "female",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
},
{
"id": 11,
"name": "Puck",
"language_id": 1,
"gender": "male",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
}
]
Este endpoint retorna uma lista de todas as vozes disponíveis que podem ser usadas ao criar ou atualizar assistentes, com filtragem opcional por modo de assistente e idioma.
Parâmetros de Consulta
string
Filtrar vozes por modo de assistente. Opções:
pipeline, multimodal, dualplexinteger
Filtrar vozes por ID de idioma. Use o endpoint Obter Idiomas para obter os IDs de idiomas disponíveis.
integer
Filtrar vozes por ID de provedor de TTS (por exemplo, ElevenLabs, Cartesia, Azure). Use o endpoint Obter Provedores de Sintetizador para obter os IDs de provedores disponíveis.
string
Filtrar vozes por gênero (por exemplo,
masculino, feminino).string
Filtrar vozes por categoria de idade (por exemplo,
Jovem, Meia-idade).string
Filtrar vozes por sotaque (por exemplo,
Americano, Britânico).string
Pesquisa em texto livre pelo nome da voz, sotaque, idade e gênero.
Campos de Resposta
array
Show propriedades
Show propriedades
integer
O identificador único da voz
string
O nome exibido da voz
integer
O ID do idioma com o qual esta voz está associada
string
O gênero da voz (masculino/feminino)
string
URL para uma amostra de áudio da voz. Pode ser usado para permitir que os usuários visualizem as vozes antes de selecionar uma.
string
O sotaque da voz (por exemplo, “Americano”, “Britânico”). Pode ser
null.string
A categoria de idade da voz (por exemplo, “Jovem”, “Meia-idade”). Pode ser
null.integer
O ID do provedor de TTS ao qual esta voz pertence. Use o endpoint Obter Provedores de Sintetizador para resolver os nomes dos provedores. Pode ser
null.[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": null
},
{
"id": 10,
"name": "Zephyr",
"language_id": 1,
"gender": "female",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
},
{
"id": 11,
"name": "Puck",
"language_id": 1,
"gender": "male",
"preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
"accent": null,
"age": "Meia-idade",
"synthesizer_provider_id": 1
}
]
Notas
- Use o campo
idcomovoice_idao criar ou atualizar assistentes - Filtre por
modepara obter apenas vozes compatíveis com o tipo de assistente pretendido - Filtre por
language_idpara obter vozes para um idioma específico - Filtre por
gender,ageouaccentpara restringir a lista, ou usesearchpara correspondência em texto livre nesses campos - Se nenhum filtro for fornecido, todas as vozes disponíveis serão retornadas
- Apenas vozes que são públicas ou pertencem ao usuário autenticado são retornadas

