Iodine docs home iodine. docs

Voices

List the voices you can use, and clone a voice from a short recording.

List voices

http
GET https://api.iodine.dev/v1/voices
Authorization: Bearer io_live_...
json
{
  "voices": [
    {
      "id": "vc_4fK9zQ2mXp7LrT1a",
      "model": "v2",
      "name": "Narrator (Sam)",
      "custom": true,
      "durationSeconds": 18.4,
      "createdAt": "2026-11-09T12:00:00Z"
    },
    { "id": "mia", "model": "v2", "languages": ["en", "es", "fr", "de", "ja", "zh"] },
    { "id": "katie", "model": "v1" }
  ]
}

Your account's cloned voices come first, then the shared voices. Each entry says which model speaks it, and v2 voices list the languages they speak. Use the id as voice in a request. Voices are added over time, so read the list rather than hard-coding it; the console's playground lets you hear every voice.

Voices

VoiceModelCharacter
avav1Warm, natural and expressive, for conversational agents.
katiev1Clear and reassuring, for support lines and service.
sophiev1Bright and energetic, for games and interactive apps.
miav2Soft, calm and close, for wellness and coaching.
chloev2Quick, chatty and fun, for social apps and entertainment.
zanderv2Low, warm and expressive, for audiobooks and narration.
ethanv2Gentle and steady, for healthcare and onboarding.

v2 voices speak English, Spanish, French, German, Japanese and Chinese, and take emotion and delivery cues.

Cloning

Clone a voice from a 3 to 30 second recording of one person speaking. Cloned voices are spoken by v2, are private to your account (nobody else can see or use them) and are never used for training.

bash
curl https://api.iodine.dev/v1/voices \
  -H "Authorization: Bearer $IODINE_API_KEY" \
  -F name="Narrator (Sam)" \
  -F file=@sam.wav \
  -F consent=true

Multipart form fields:

Field
filerequiredThe recording: WAV, MP3, FLAC or OGG, 3 to 30 seconds, up to 20 MB. 10 to 30 seconds of clear speech with no music or other voices works best.
namerequired1 to 64 characters, for your own reference.
consentrequiredtrue. You confirm that the speaker has given permission for their voice to be cloned. We record which key confirmed it.
transcriptoptionalWhat's said in the recording, up to 2,000 characters. Left out, we transcribe it for you. An accurate transcript gives a closer clone.

The response is 201 Created:

json
{
  "voice": {
    "id": "vc_4fK9zQ2mXp7LrT1a",
    "model": "v2",
    "name": "Narrator (Sam)",
    "custom": true,
    "durationSeconds": 18.4,
    "createdAt": "2026-11-09T12:00:00Z",
    "transcript": "Hi, I'm Sam, and this is how I sound when I read.",
    "transcriptSource": "auto"
  }
}

transcriptSource is provided, auto (we transcribed it) or none (no transcript could be made; the voice still works, just less closely). Use the new id straight away:

bash
curl https://api.iodine.dev/v1/tts \
  -H "Authorization: Bearer $IODINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Chapter one.", "voice": "vc_4fK9zQ2mXp7LrT1a"}' \
  --output chapter-1.wav

An account can keep up to 50 cloned voices.

Only clone voices you have permission to use

Clone a voice only if you are the speaker, or the speaker has given you permission to clone it and to use it as you intend; you must be able to show that permission if we ask. Don't use any voice to impersonate a real person without their consent, to mislead anyone about who is speaking, or to commit fraud. We may delete a cloned voice, and suspend the account that made it, if it breaks these rules. See the Terms.

Delete a cloned voice

http
DELETE https://api.iodine.dev/v1/voices/vc_4fK9zQ2mXp7LrT1a
Authorization: Bearer io_live_...

Returns 204 No Content. The recording is deleted and the id stops working at once.

‹  Realtime Speech to text  ›