Voices

Preview a voice

Changed on

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

post/v1/voices/preview

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/voices/preview
  • Auth
    HTTP bearer

Headers

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

The version of the RunwayML API being used. You can read more about versioning here.

Request body

promptstring 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

Success

urlstring uri required

A presigned URL to the audio preview. The URL expires after 24 hours.

durationSecsnumber required

Duration of the audio preview in seconds.

Changes