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

# Preview a voice

`POST /v1/voices/preview`

Generate a short audio preview of a voice from a text description. Use this to audition a voice before creating it.

## Headers

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

## Request body

- object
  - `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
  - `url` string, uri, required — A presigned URL to the audio preview. The URL expires after 24 hours.
  - `durationSecs` number, required — Duration of the audio preview in seconds.

---

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