---
title: "Create a voice from audio"
method: POST
path: "/voices"
---

# Create a voice from audio

`POST /voices`

Creates a custom voice by cloning from an audio file.

## Request body

- VoiceCreateArgs
  - `name` string, required — Name of the voice
  - `audioUrl` string, uri, required — HTTPS URL to the audio file for voice cloning (MP3, WAV, M4A). Duration must be between 30 seconds and 4 minutes.
  - `modelId` 'eleven_multilingual_v2' | 'eleven_multilingual_v1' | 'eleven_monolingual_v1' | 'eleven_turbo_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_v3' | 'speech-02-hd' | 'speech-02-turbo' | 'speech-2.5-hd-preview' | 'speech-2.5-turbo-preview' | 'speech-2.6-hd' | 'speech-2.6-turbo' | 'speech-2.8-hd' | 'speech-2.8-turbo' — Voice model to use for TTS. Determines which provider (ElevenLabs or Minimax) and which settings are available.
  - `settings` VoiceSettings — Model-specific voice settings. Available fields depend on the chosen modelId. See the Settings by Model section for details.
    - `voiceStability` number — ElevenLabs only. Voice stability (0-1). Default: 0.8 (0.5 for eleven_v3)
    - `voiceSimilarity` number — ElevenLabs only. Clarity + similarity (0-1). Default: 0.5
    - `voiceStyle` number — ElevenLabs only. Style exaggeration (0-1). Default: 0.0
    - `voiceSpeed` number — ElevenLabs and Minimax. Playback speed (0.7-1.2). Default: 1.0
    - `speakerBoost` boolean — ElevenLabs only (not available for eleven_v3). Enable speaker boost. Default: true
    - `languageBoost` 'auto' | 'Afrikaans' | 'Arabic' | 'Bulgarian' | 'Catalan' | 'Chinese' | 'Chinese,Yue' | 'Croatian' | 'Czech' | 'Danish' | 'Dutch' | 'English' | 'Filipino' | 'Finnish' | 'French' | 'German' | 'Greek' | 'Hebrew' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Malay' | 'Norwegian' | 'Nynorsk' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Slovak' | 'Slovenian' | 'Spanish' | 'Swedish' | 'Tamil' | 'Thai' | 'Turkish' | 'Ukrainian' | 'Vietnamese'
    - `emotion` 'auto' | 'happy' | 'sad' | 'angry' | 'fearful' | 'disgusted' | 'surprised' | 'neutral'
  - `language` 'ENGLISH' | 'SPANISH' | 'FRENCH' | 'PORTUGUESE' | 'GERMAN' | 'RUSSIAN' | 'HINDI' | 'CHINESE' | 'DUTCH' | 'ARABIC' | 'POLISH' | 'BULGARIAN' | 'JAPANESE' | 'ITALIAN'
  - `gender` 'MALE' | 'FEMALE'

## Response `201`

Voice created successfully

- Voice
  - `id` string, uuid
  - `name` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `status` string
  - `sampleUrl` string
  - `language` 'ENGLISH' | 'SPANISH' | 'FRENCH' | 'PORTUGUESE' | 'GERMAN' | 'RUSSIAN' | 'HINDI' | 'CHINESE' | 'DUTCH' | 'ARABIC' | 'POLISH' | 'BULGARIAN' | 'JAPANESE' | 'ITALIAN', nullable
  - `gender` 'MALE' | 'FEMALE', nullable

## Other responses

- `400` — Validation error (invalid audio, quota exceeded, etc.)

## Changes

- **2026-03-25** `b81689a2c8e7` — 53 breaking
  - added `#/components/schemas/MinimaxEmotion` to the `settings/emotion` request property `allOf` list
  - added `#/components/schemas/MinimaxLanguageBoost` to the `settings/languageBoost` request property `allOf` list
  - removed the enum value `Afrikaans` of the request property `settings/languageBoost`
  - removed the enum value `Arabic` of the request property `settings/languageBoost`
  - …49 more
- **2026-03-25** `11bbdfca1392` — 2 breaking, 7 info
  - removed `#/components/schemas/ElevenLabsSettings, #/components/schemas/ElevenLabsV3Settings, #/components/schemas/MinimaxSettings` from the `settings` request property `oneOf` list
  - the `settings` request property type/format changed from ``/`` to `object`/``
  - added the new optional request property `settings/emotion`
  - added the new optional request property `settings/languageBoost`
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/argildotai/apis/argil-api/changes/voices/post.md)

---

[API](https://skmtc.dev/argildotai/apis/argil-api.md) · [All operations](https://skmtc.dev/argildotai/apis/argil-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/argildotai/argil-api/revisions/f3d0315da0f0/schema)