음성

내레이션 음성, 미리듣기, 그리고 전송할 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를 전송하세요.

제공되는 음성 목록

현재 카탈로그에는 엄선된 6명의 내레이터가 있습니다: Nora, Miles, Dean, Clara, Piper, Wren. 이 음성들은 언어에 구애받지 않으므로, 선택한 하나의 음성이 GET /v1/languages에 나열된 모든 언어를 말합니다. 음성 카탈로그가 반환하는 정확한 id를 사용하세요.

id를 하드코딩하지 말고 discovery를 사용하세요. 런타임에 카탈로그를 읽으면 통합이 공개 목록의 추가 및 변경 사항을 자동으로 따라갑니다.