---
title: "Create a voice"
method: POST
path: "/v1/voices"
tags: ["Voices"]
---

# Create a voice

`POST /v1/voices`

Create a custom voice from a text description, or clone a voice from an audio sample.

## Headers

- `X-Runway-Version` '2024-11-06', required

## Request body

- object
  - `name` string, required — A name for the voice.
  - `description` string, nullable — An optional description of the voice.
  - `from` union, required
    - object
      - `type` 'audio', required
      - `audio` union, required — Audio sample to clone the voice from. Must be between 10 seconds and 5 minutes long and at most 10MB. For best results, use a clear recording with minimal background noise and varied tone.
        - string — A HTTPS URL, Runway upload URI, or base64 data URI (e.g. `data:audio/mp3;base64,...`, up to 16MB) containing an encoded audio. See [our docs](/assets/inputs#audio) on audio inputs for more information.
        - string — A Runway upload URI. See https://docs.dev.runwayml.com/assets/uploads for more information.
        - string — A data URI containing encoded media.
    - object
      - `type` 'text', required
      - `prompt` string, required — A text description of the desired voice characteristics. Must be at least 20 characters.
      - `model` 'eleven_ttv_v3' | 'eleven_multilingual_ttv_v2', required — The voice design model to use. Prefer eleven_ttv_v3 (latest); eleven_multilingual_ttv_v2 is the previous generation.

## Response `200`

Success

- object
  - `id` string, uuid, required — The ID of the voice that was created.

---

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