---
title: "Create Voice"
method: POST
path: "/v1/voices/create"
tags: ["voices"]
---

# Create Voice

`POST /v1/voices/create`

## Request body

- union
  - AzureVoiceParams
    - `type` 'voice_azure', required
    - `voice_name` string, required
    - `pitch` integer
    - `rate` integer
  - RimeVoiceParams
    - `type` 'voice_rime', required
    - `speaker` string, required
    - `speed_alpha` number, nullable
    - `model_id` union
      - 'mist' | 'v1'
      - Undefined
  - ElevenLabsVoiceParams
    - `type` 'voice_eleven_labs', required
    - `voice_id` string, required
    - `stability` number, nullable
    - `similarity_boost` number, nullable
    - `api_key` string, nullable
    - `optimize_streaming_latency` integer, nullable
    - `model_id` string, nullable
    - `experimental_input_streaming` boolean
  - PlayHtVoiceParams
    - `type` 'voice_play_ht', required
    - `voice_id` string, required
    - `api_user_id` string, nullable
    - `api_key` string, nullable
    - `version` '1' | '2'
    - `speed` number, nullable
    - `quality` 'faster' | 'draft' | 'low' | 'medium' | 'high' | 'premium', nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `text_guidance` number, nullable
    - `voice_guidance` number, nullable
    - `experimental_remove_silence` boolean
  - VocodeVoiceParams
    - `type` 'voice_vocode', required
    - `voice_id` 'joe', required

## Response `200`

Successful Response

- union
  - AzureVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_azure', required
    - `voice_name` string, required
    - `pitch` integer
    - `rate` integer
  - RimeVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_rime', required
    - `speaker` string, required
    - `speed_alpha` number, nullable
    - `model_id` union
      - 'mist' | 'v1'
      - Undefined
  - ElevenLabsVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_eleven_labs', required
    - `voice_id` string, required
    - `stability` number, nullable
    - `similarity_boost` number, nullable
    - `api_key` string, nullable
    - `optimize_streaming_latency` integer, nullable
    - `model_id` string, nullable
    - `experimental_input_streaming` boolean
  - PlayHtVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_play_ht', required
    - `voice_id` string, required
    - `api_user_id` string, nullable
    - `api_key` string, nullable
    - `version` '1' | '2'
    - `speed` number, nullable
    - `quality` 'faster' | 'draft' | 'low' | 'medium' | 'high' | 'premium', nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `text_guidance` number, nullable
    - `voice_guidance` number, nullable
    - `experimental_remove_silence` boolean
  - VocodeVoice
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'voice_vocode', required
    - `voice_id` 'joe', required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 25 breaking, 29 info
  - the `type` request property const value `voice_azure` was added
  - the `type` request property const value `voice_eleven_labs` was added
  - the `type` request property const value `voice_play_ht` was added
  - the `type` request property const value `voice_rime` was added
  - …50 more
- **2024-04-15** `47ab17602d64` — 2 info
  - added the new optional request property `oneOf[subschema #2: RimeVoiceParams]/model_id`
  - added the optional property `oneOf[subschema #2: RimeVoice]/model_id` to the response with the `200` status
- **2024-03-18** `500a519452b0` — 10 info
  - added the new optional request property `oneOf[subschema #3: ElevenLabsVoiceParams]/experimental_input_streaming`
  - added the new optional request property `oneOf[subschema #4: PlayHtVoiceParams]/experimental_remove_silence`
  - added the new optional request property `oneOf[subschema #4: PlayHtVoiceParams]/text_guidance`
  - added the new optional request property `oneOf[subschema #4: PlayHtVoiceParams]/top_p`
  - …6 more
- …earlier changes not shown

[Full history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/voices/create/post.md)

---

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