ボイス

ナレーションボイス、その試聴、そして送信する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という厳選された6人のナレーターが含まれます。これらのボイスは言語に依存しないため、選択した1つのボイスがGET /v1/languagesに記載されたすべての言語を話します。ボイスカタログが返す正確なidを使用してください。

idをハードコードせず、discoveryを活用してください。実行時にカタログを読み込めば、公開ラインナップへの追加や変更に統合が自動的に追従します。