Verfügbare Stimmen abrufen
curl --request GET \
--url https://app.famulor.de/api/user/assistants/voices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.de/api/user/assistants/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.famulor.de/api/user/assistants/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/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://app.famulor.de/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))
}[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Middle aged",
"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": "Middle aged",
"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": "Middle aged",
"synthesizer_provider_id": 1
}
]
Verfügbare Stimmen abrufen
Alle verfügbaren Stimmen für die Assistenten-Konfiguration abrufen
GET
/
api
/
user
/
assistants
/
voices
Verfügbare Stimmen abrufen
curl --request GET \
--url https://app.famulor.de/api/user/assistants/voices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.famulor.de/api/user/assistants/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.famulor.de/api/user/assistants/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/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://app.famulor.de/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))
}[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Middle aged",
"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": "Middle aged",
"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": "Middle aged",
"synthesizer_provider_id": 1
}
]
Dieser Endpunkt gibt eine Liste aller verfügbaren Stimmen zurück, die beim Erstellen oder Aktualisieren von Assistenten verwendet werden können, mit optionaler Filterung nach Assistenten-Modus und Sprache.
Query-Parameter
string
Stimmen nach Assistenten-Modus filtern. Optionen:
pipeline, multimodal, dualplexinteger
Stimmen nach Sprach-ID filtern. Verwende den Endpunkt Sprachen abrufen, um verfügbare Sprach-IDs zu erhalten.
Antwort-Felder
array
Anzeigen Eigenschaften
Anzeigen Eigenschaften
integer
Die eindeutige Kennung der Stimme
string
Der Anzeigename der Stimme
integer
Die Sprach-ID, der diese Stimme zugeordnet ist
string
Das Geschlecht der Stimme (male/female)
string
URL zu einem Audio-Beispiel der Stimme. Kann verwendet werden, um Nutzern eine Vorschau der Stimme zu ermöglichen, bevor sie ausgewählt wird.
string
Der Akzent der Stimme (z.B. „American“, „British“). Kann
null sein.string
Die Alterskategorie der Stimme (z.B. „Young“, „Middle aged“). Kann
null sein.integer
Die TTS-Provider-ID, zu der diese Stimme gehört. Verwende den Endpunkt Synthesizer-Provider abrufen, um Providernamen aufzulösen. Kann
null sein.[
{
"id": 1,
"name": "Alloy",
"language_id": 1,
"gender": "female",
"preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
"accent": null,
"age": "Middle aged",
"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": "Middle aged",
"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": "Middle aged",
"synthesizer_provider_id": 1
}
]
Hinweise
- Verwende das
id-Feld alsvoice_idbeim Erstellen oder Aktualisieren von Assistenten - Filtere nach
mode, um nur Stimmen zu erhalten, die mit deinem gewünschten Assistenten-Typ kompatibel sind - Filtere nach
language_id, um Stimmen für eine bestimmte Sprache zu erhalten - Wenn keine Filter angegeben werden, werden alle verfügbaren Stimmen zurückgegeben
- Nur Stimmen, die öffentlich sind oder dem authentifizierten Benutzer gehören, werden zurückgegeben