---
title: "Create Voice from Design Preview"
method: POST
path: "/v0/assistant/voice/design/create"
tags: ["Voices", "TTS Design"]
---

# Create Voice from Design Preview

`POST /v0/assistant/voice/design/create`

Creates a full voice from a generated preview voice id.

## Request body

- VoiceDesignCreateFromPreviewRequest
  - `generated_voice_id` string, required — The 'generated_voice_id' obtained from the '/design/preview'.
  - `voice_name` string, required — Name for the new voice.
  - `voice_description` string, required — Description for the new voice.
  - `audio_base_64` string, nullable — Base64 encoded audio sample from the selected voice preview. If provided, it's used for language detection.
  - `media_type` string, nullable — MIME type of the audio sample, e.g., 'audio/mpeg'. Assumed 'audio/mpeg' if sample is provided but this is omitted.
  - `labels` object, nullable — Optional labels for ElevenLabs when creating the voice.
  - `language` string, nullable — Language of the voice. If not provided, it will be auto-detected from the provided audio preview, or from the description if no audio is provided.
  - `gender` string, nullable — Gender of the voice.

## Response `201`

Successful Response

- InfoResponseVoiceRead
  - `info` VoiceRead, required — Schema for reading voice data from the DB.
    - `voice_id` string, required — Provider Voice ID
    - `name` string, required — User-given name for the voice
    - `description` string, required — Description of the voice
    - `gender` string, nullable — Gender of the voice
    - `language` string, required — Language code of the voice
    - `provider` 'cartesia' | 'elevenlabs' | 'openai' — Provider of the voice (cartesia, elevenlabs or openai)
    - `is_preset` boolean, nullable — Whether this voice is a preset or user-created voice.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/versions/900377f918b6/schema)