v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Voices

Preview a voice

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

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.