---
title: "Create Voice Sample"
method: POST
path: "/api/v1/voice_groups/voices/sample"
tags: ["voice_groups"]
---

# Create Voice Sample

`POST /api/v1/voice_groups/voices/sample`

Generate voice sample.

## Request body

- VoiceSampleCreateRequest — Request model to generate a sample audio file for a given voice and language.
  - `language_code` 'yue-HK' | 'en-US' | 'ko-KR' | 'zh-CN' | 'fa-IR' | 'es-US' | 'th-TH' | 'vi-VN' | 'bs-BA' | 'sw-KE' | 'ru-RU' | 'hi-IN' | 'gu-IN' | 'ar-XA' | 'fr-FR' | 'ja-JP' | 'ne-NP', required — BCP 47 codes of languages that Syllable supports.
  - `voice_provider` 'OpenAI' | 'ElevenLabs' | 'Google', required — TTS provider for an agent voice.
  - `voice_display_name` 'Achernar (English)' | 'Achernar (Gujarati)' | 'Achernar (Arabic)' | 'Achernar (French)' | 'Achernar (Japanese)' | 'Achernar (Hindi)' | 'Achernar (Korean)' | 'Achernar (Mandarin)' | 'Achernar (Spanish)' | 'Achernar (Thai)' | 'Achernar (Vietnamese)' | 'Alice' | 'Alloy' | 'Aoede (English)' | 'Aoede (Gujarati)' | 'Aoede (Arabic)' | 'Aoede (French)' | 'Aoede (Japanese)' | 'Aoede (Hindi)' | 'Aoede (Korean)' | 'Aoede (Mandarin)' | 'Aoede (Russian)' | 'Aoede (Spanish)' | 'Aoede (Thai)' | 'Aoede (Vietnamese)' | 'Ash' | 'Bill' | 'Brian' | 'Callirrhoe (English)' | 'Callirrhoe (Gujarati)' | 'Callirrhoe (Arabic)' | 'Callirrhoe (French)' | 'Callirrhoe (Japanese)' | 'Callirrhoe (Hindi)' | 'Callirrhoe (Korean)' | 'Callirrhoe (Mandarin)' | 'Callirrhoe (Spanish)' | 'Callirrhoe (Thai)' | 'Callirrhoe (Vietnamese)' | 'Callum' | 'Charlie' | 'Charlotte' | 'Charon (English)' | 'Charon (Gujarati)' | 'Charon (Arabic)' | 'Charon (French)' | 'Charon (Japanese)' | 'Charon (Hindi)' | 'Charon (Korean)' | 'Charon (Mandarin)' | 'Charon (Russian)' | 'Charon (Spanish)' | 'Charon (Thai)' | 'Charon (Vietnamese)' | 'Chris' | 'cmn-TW-Wavenet-A' | 'Coral' | 'Daniel' | 'Echo' | 'en-US-Neural2-D' | 'en-US-Neural2-F' | 'en-US-Neural2-J' | 'en-US-Studio-O' | 'Eric' | 'es-US-Neural2-A' | 'es-US-Neural2-B' | 'Fable' | 'Fenrir (English)' | 'Fenrir (Gujarati)' | 'Fenrir (Arabic)' | 'Fenrir (French)' | 'Fenrir (Japanese)' | 'Fenrir (Hindi)' | 'Fenrir (Korean)' | 'Fenrir (Mandarin)' | 'Fenrir (Russian)' | 'Fenrir (Spanish)' | 'Fenrir (Thai)' | 'Fenrir (Vietnamese)' | 'George' | 'Jessica' | 'ko-KR-Neural2-A' | 'Kore (English)' | 'Kore (Gujarati)' | 'Kore (Arabic)' | 'Kore (French)' | 'Kore (Japanese)' | 'Kore (Hindi)' | 'Kore (Korean)' | 'Kore (Mandarin)' | 'Kore (Russian)' | 'Kore (Spanish)' | 'Kore (Thai)' | 'Kore (Vietnamese)' | 'Laura' | 'Leda (English)' | 'Leda (Gujarati)' | 'Leda (Arabic)' | 'Leda (French)' | 'Leda (Japanese)' | 'Leda (Hindi)' | 'Leda (Korean)' | 'Leda (Mandarin)' | 'Leda (Russian)' | 'Leda (Spanish)' | 'Leda (Thai)' | 'Leda (Vietnamese)' | 'Liam' | 'Lily' | 'Matilda' | 'Nova' | 'Onyx' | 'Orus (English)' | 'Orus (Gujarati)' | 'Orus (Arabic)' | 'Orus (French)' | 'Orus (Japanese)' | 'Orus (Hindi)' | 'Orus (Korean)' | 'Orus (Mandarin)' | 'Orus (Russian)' | 'Orus (Spanish)' | 'Orus (Thai)' | 'Orus (Vietnamese)' | 'Puck (English)' | 'Puck (Gujarati)' | 'Puck (Arabic)' | 'Puck (French)' | 'Puck (Japanese)' | 'Puck (Hindi)' | 'Puck (Korean)' | 'Puck (Mandarin)' | 'Puck (Russian)' | 'Puck (Spanish)' | 'Puck (Thai)' | 'Puck (Vietnamese)' | 'River' | 'Roger' | 'Sarah' | 'Sage' | 'Shimmer' | 'Umbriel (English)' | 'Umbriel (Gujarati)' | 'Umbriel (Arabic)' | 'Umbriel (French)' | 'Umbriel (Japanese)' | 'Umbriel (Hindi)' | 'Umbriel (Korean)' | 'Umbriel (Mandarin)' | 'Umbriel (Spanish)' | 'Umbriel (Thai)' | 'Umbriel (Vietnamese)' | 'Vindemiatrix (English)' | 'Vindemiatrix (Gujarati)' | 'Vindemiatrix (Arabic)' | 'Vindemiatrix (French)' | 'Vindemiatrix (Japanese)' | 'Vindemiatrix (Hindi)' | 'Vindemiatrix (Korean)' | 'Vindemiatrix (Mandarin)' | 'Vindemiatrix (Spanish)' | 'Vindemiatrix (Thai)' | 'Vindemiatrix (Vietnamese)' | 'vi-VN-Neural2-A' | 'Will' | 'yue-HK-Standard-C' | 'Zephyr (English)' | 'Zephyr (Gujarati)' | 'Zephyr (Arabic)' | 'Zephyr (French)' | 'Zephyr (Japanese)' | 'Zephyr (Hindi)' | 'Zephyr (Korean)' | 'Zephyr (Mandarin)' | 'Zephyr (Russian)' | 'Zephyr (Spanish)' | 'Zephyr (Thai)' | 'Zephyr (Vietnamese)', required — Display names of voices that Syllable supports.
  - `voice_speed` number, nullable — Speed of the voice in the range of 0.25 to 4.0 (OpenAI and Google) or 0.7 to 1.2 (ElevenLabs). Standard speed is 1.0.
  - `voice_pitch` number, nullable — Pitch of the voice in the range of -20.0 to 20.0. 20 means increase 20 semitones from the original pitch. -20 means decrease 20 semitones from the original pitch. 0 means use the original pitch. Only supported for Google configs.
  - `text` string — Text to generate for this voice.
  - `apply_pronunciation_overrides` boolean — Apply TTS pronunciation fixes.

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/versions/ac3228f980bb/schema)