Zum Hauptinhalt springen
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>'
[
  {
    "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

​
mode
string
Stimmen nach Assistenten-Modus filtern. Optionen: pipeline, multimodal, dualplex
​
language_id
integer
Stimmen nach Sprach-ID filtern. Verwenden Sie den Endpunkt Sprachen abrufen, um verfügbare Sprach-IDs zu erhalten.

​
Antwort-Felder

​
data
array
[
  {
    "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

  • Verwenden Sie das id-Feld als voice_id beim Erstellen oder Aktualisieren von Assistenten
  • Filtern Sie nach mode, um nur Stimmen zu erhalten, die mit Ihrem gewünschten Assistenten-Typ kompatibel sind
  • Filtern Sie 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