---
title: "Design a voice from a description"
method: POST
path: "/v1/voices/design"
tags: ["voices"]
---

# Design a voice from a description

`POST /v1/voices/design`

## Request

- Base URL: `https://varosity.ai/api`
- URL: `https://varosity.ai/api/v1/voices/design`
- Auth: HTTP bearer

ElevenLabs Voice Design. Returns audition previews; pass voiceName to also save the first preview as a reusable voice. Scope: generate:voice.

## Request body

- object
  - `voiceDescription` string, required
  - `text` string
  - `voiceName` string

## Response `201`

Success

- object
  - `ok` boolean, required
  - `previews` object[], required
    - `generatedVoiceId` string, required
    - `audioUrl` string, required
  - `voiceId` string, nullable, required

## Other responses

- `401`: Unauthorized
- `422`: Validation error

---

[API](https://skmtc.dev/varosity/apis/varosity-ai-api.md) · [All operations](https://skmtc.dev/varosity/apis/varosity-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/varosity/apis/varosity-ai-api/revisions/81d0169a4897?raw)