Mga Boses

Mga boses ng pagsasalaysay, ang kanilang mga preview, at ang id na ipapadala. Opsyonal ang boses: alisin ito at Sketchie ay magsasalaysay gamit si Nora.

Opsyonal ang field na voice. Alisin ito at magsasalaysay ang Sketchie gamit si Nora, ang mainit na multi-purpose default na tagapagsalaysay. Itakda lamang kapag gusto mo ng ibang boses.

Tuklasin ang mga boses

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

Tawagin ang katalogo ng boses upang ilista ang bawat tagapagsalaysay. Bawat boses ay bumabalik kasama ang isang palakaibigang name na ipapakita sa iyong mga user, ang id na ipapasa bilang voice, ang katutubong language nito, isang isDefault flag, at isang mape-play na preview_url na maaari mong ikonekta nang direkta sa isang audio player.

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

Ipasa ang ?language=<code> upang i-filter sa mga boses na katutubo sa isang wika. Maaari mo ring ilista ang mga boses mula sa CLI (sketchie voices) o sa SDK (client.listVoices()). Palaging ipakita ang palakaibigang name sa iyong mga user, at ipadala ang id sa API.

Ang naisalaysay na roster ng boses

Ang kasalukuyang katalogo ay naglalaman ng anim na pinili nang tagapagsalaysay: Nora, Miles, Dean, Clara, Piper, at Wren. Ang mga boses na ito ay hindi nakatali sa wika, kaya ang parehong napiling boses ay nagsasalita ng bawat wikang nakalista ng GET /v1/languages. Gamitin ang eksaktong id na ibinabalik ng katalogo ng boses.

Gumamit ng discovery, hindi hard-coded na id. Basahin ang katalogo sa runtime upang awtomatikong sundan ng iyong integrasyon ang mga karagdagan at pagbabago sa pampublikong roster.