---
title: "Design Voice Previews"
method: POST
path: "/v0/assistant/voice/design/preview"
tags: ["Voices", "TTS Design"]
---

# Design Voice Previews

`POST /v0/assistant/voice/design/preview`

Generates voice design previews from a text description.

## Request body

- VoiceDesignGeneratePreviewsRequest
  - `voice_description` string, nullable — Text prompt describing the desired voice characteristics (e.g., 'A deep, resonant male voice with a British accent, suitable for narration.'). If `bio` is provided, this field can be used to add more specific voice instructions. At least one of bio or voice_description should be provided.
  - `bio` string, nullable — A biography or background of the character to generate a voice description from. Used with `voice_description` to generate a richer prompt for the TTS provider. At least one of bio or voice_description should be provided.
  - `text` string, nullable — Optional: Text to be spoken in the generated voice previews. If not provided, and auto_generate_text is false, ElevenLabs might use a default or generic text.
  - `auto_generate_text` boolean, nullable — Optional: Whether to automatically generate a text suitable for the voice description if 'text' is not provided. Defaults to false by ElevenLabs.
  - `model_id` 'eleven_multilingual_ttv_v2' | 'eleven_ttv_v3', nullable — Optional: Model to use for voice generation.

## Response `200`

Successful Response

- InfoResponseVoiceDesignGeneratePreviewsAPIResponse
  - `info` VoiceDesignGeneratePreviewsAPIResponse, required
    - `previews` VoiceDesignPreviewItem[], required
      - `audio_base_64` string, required — Base64 encoded audio sample of the generated voice preview.
      - `generated_voice_id` string, required — Temporary ID for this generated voice preview, used to create the full voice.
      - `media_type` string, required — MIME type of the audio sample, e.g., 'audio/mpeg'.
      - `duration_secs` number, nullable — Duration of the audio sample in seconds.
    - `text` string, required

## 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)