Voix

Les voix de narration, leurs aperçus et l’id à envoyer. La voix est optionnelle : omettez-la et Sketchie narre avec Nora.

Le champ voice est optionnel. Omettez-le et Sketchie narre avec Nora, la narratrice chaleureuse et polyvalente par défaut. Ne le définissez que pour une autre voix.

Découvrez les voix

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

Appelez le catalogue de voix pour lister chaque narrateur. Chaque voix revient avec un name convivial à montrer à vos utilisateurs, l’id à passer comme voice, sa language native, un indicateur isDefault, et une preview_url jouable que vous branchez directement dans un lecteur audio.

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"
}

Passez ?language=<code> pour filtrer sur les voix natives d’une langue. Vous pouvez aussi lister les voix depuis la CLI (sketchie voices) ou le SDK (client.listVoices()). Montrez toujours le name convivial à vos utilisateurs, et envoyez l’id à l’API.

Le casting de voix livré

Le catalogue actuel contient six narrateurs soignés : Nora, Miles, Dean, Clara, Piper et Wren. Ces voix sont indépendantes de la langue, donc la même voix choisie parle toutes les langues listées par GET /v1/languages. Utilisez l’id exact renvoyé par le catalogue de voix.

Utilisez la découverte, pas des ids codés en dur. Lisez le catalogue à l’exécution pour que votre intégration suive automatiquement les ajouts et changements du casting public.