Suara

Suara narasi, pratinjaunya, dan id yang dikirim. Suara opsional: hilangkan dan Sketchie bernarasi dengan Nora.

Field voice bersifat opsional. Hilangkan dan Sketchie bernarasi dengan Nora, narator bawaan yang hangat dan serbaguna. Setel hanya bila Anda ingin suara berbeda.

Temukan suaranya

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

Panggil katalog suara untuk mendaftar tiap narator. Setiap suara kembali dengan name ramah untuk ditampilkan ke pengguna Anda, id untuk dikirim sebagai voice, language aslinya, flag isDefault, dan preview_url yang bisa diputar yang bisa Anda sambungkan langsung ke pemutar 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"
}

Kirim ?language=<code> untuk memfilter ke suara asli sebuah bahasa. Anda juga bisa mendaftar suara dari CLI (sketchie voices) atau SDK (client.listVoices()). Selalu tampilkan name ramah ke pengguna Anda, dan kirim id ke API.

Jajaran suara yang tersedia

Katalog saat ini berisi enam narator pilihan: Nora, Miles, Dean, Clara, Piper, dan Wren. Suara-suara ini tidak terikat bahasa, jadi suara yang sama yang dipilih berbicara di setiap bahasa yang didaftar oleh GET /v1/languages. Gunakan id persis yang dikembalikan katalog suara.

Gunakan discovery, bukan id yang ditulis keras. Baca katalog saat runtime agar integrasi Anda otomatis mengikuti penambahan dan perubahan pada jajaran publik.