Stimmen

Erzählstimmen, ihre Vorschauen und die zu sendende id. Die Stimme ist optional: lass sie weg und Sketchie erzählt mit Nora.

Das Feld voice ist optional. Lass es weg und Sketchie erzählt mit Nora, der warmen Allzweck-Standard-Erzählstimme. Setze es nur, wenn du eine andere Stimme willst.

Entdecke die Stimmen

GET https://sketchie.ai/api/v1/voices

Rufe den Stimmenkatalog auf, um jede Erzählstimme zu listen. Jede Stimme kommt mit einem freundlichen name für deine Nutzer zurück, der id, die als voice übergeben wird, ihrer nativen language, einem isDefault-Flag und einer abspielbaren preview_url, die du direkt in einen Audio-Player einbinden kannst.

200 OK

{
  "voices": [
    {
      "id": "sketchie:sulafat",
      "name": "Nora",
      "language": "en",
      "description": "Warm and natural, like a favorite teacher.",
      "isDefault": true,
      "preview_url": "https://sketchie.ai/media/voice-previews/sulafat.mp3"
    }
  ],
  "default": "sketchie:sulafat"
}

Übergib ?language=<code>, um auf Stimmen zu filtern, die in einer Sprache nativ sind. Du kannst Stimmen auch über die CLI (sketchie voices) oder das SDK (client.listVoices()) auflisten. Zeige deinen Nutzern immer den freundlichen name und sende die id an die API.

Das ausgelieferte Stimmen-Ensemble

Der aktuelle Katalog enthält sechs kuratierte Erzählstimmen: Nora, Miles, Dean, Clara, Piper und Wren. Diese Stimmen sind sprachunabhängig, sodass dieselbe gewählte Stimme jede von GET /v1/languages gelistete Sprache spricht. Nutze die genaue id, die der Stimmenkatalog zurückgibt.

Nutze Discovery, keine fest codierten ids. Lies den Katalog zur Laufzeit, damit deine Integration Ergänzungen und Änderungen des öffentlichen Ensembles automatisch übernimmt.