## Preview

`voices.preview(VoicePreviewParams**kwargs)`

**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.

### Parameters

- `provider: Literal["cartesia", "elevenlabs"]`

  The provider to use for the preview.

  - `"cartesia"`

  - `"elevenlabs"`

- `voice_id: str`

  The voice ID to generate a preview for.

### Example

```python
import os
from revox import Revox

client = Revox(
    api_key=os.environ.get("REVOX_API_KEY"),  # This is the default and can be omitted
)
client.voices.preview(
    provider="cartesia",
    voice_id="voiceId",
)
```