---
title: "Preview a voice for a character"
method: POST
path: "/v1/studio/series/{seriesId}/characters/{characterId}/voice-preview"
tags: ["Studio"]
---

# Preview a voice for a character

`POST /v1/studio/series/{seriesId}/characters/{characterId}/voice-preview`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/studio/series/{seriesId}/characters/{characterId}/voice-preview`
- Auth: none declared

## Path parameters

- `seriesId` string, required
- `characterId` string, required

## Request body

- LooseJsonBody

## Response `200`

Voice preview

- StudioVoicePreview
  - `previewUrl` string, nullable, required

## Other responses

- `400`: A required field is missing (code VALIDATION_FAILED)
- `401`: Unauthorized
- `402`: Not enough credits for the preview (code BILLING_INSUFFICIENT_CREDITS)
- `404`: Series or character not found, or "Voice not found.": the voice is neither a premade/professional catalog voice nor cast on the viewer's own characters. Nothing was saved or charged.
- `503`: The voice is not one of the viewer's own and the ElevenLabs voice catalog cannot be read right now (timeout, network error or provider error). Code PROVIDER_UNAVAILABLE, reason voice_catalog_unavailable; nothing was saved or charged.

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)
