API Reference

Voices

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Generate voice preview

POST/voices/preview

Generate a short audio preview for a given voice. Provide the voice ID and provider, and the API returns an audio/mpeg stream you can play back to hear how the voice sounds before assigning it to an assistant.

Body ParametersJSONExpand Collapse

provider: "cartesia" or "elevenlabs"

The provider to use for the preview.

One of the following:

"cartesia"

"elevenlabs"

voiceId: string

The voice ID to generate a preview for.

Generate voice preview

HTTP

HTTP

TypeScript

Python

Ruby

curl https://www.getrevox.com/api/voices/preview \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $REVOX_API_KEY" \
    -d '{
          "provider": "cartesia",
          "voiceId": "voiceId"
        }'

Returns Examples