语音

旁白语音、试听以及要发送的 id。语音是可选的：省略它，Sketchie 便以 Nora 旁白。

voice 字段为可选项。省略它，Sketchie 会使用温暖百搭的默认旁白 Nora。仅在需要其他语音时才设置它。

探索语音

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

调用语音目录即可列出所有旁白。每种语音返回时都带有面向用户展示的友好 name、作为 voice 传入的 id、其原生 language、isDefault 标志，以及可直接接入音频播放器的 preview_url。

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

传入 ?language=<code> 即可筛选出某种语言的原生语音。你也可以通过 CLI（sketchie voices）或 SDK（client.listVoices()）列出语音。请始终向用户展示友好的 name，并向 API 发送 id。

已提供的语音阵容

当前目录收录了六位精选旁白：Nora、Miles、Dean、Clara、Piper 和 Wren。这些语音与语言无关，因此同一个选定语音可以讲出 GET /v1/languages 列出的每一种语言。请使用语音目录返回的准确 id。

使用发现机制，而非硬编码 id。在运行时读取目录，让你的集成自动跟进公开阵容的新增与变更。