---
title: "Get Voice Preview"
method: GET
path: "/voices/preview/{voice_id}"
tags: ["Synth Voices"]
---

# Get Voice Preview

`GET /voices/preview/{voice_id}`

Return a short-lived signed GCS URL for the voice preview audio.

Result is cached in Redis (TTL controlled by the ``VOICE_PREVIEW_CACHE_TTL`` env var,
default 10 min).

Args:
    voice_id: UUID of the voice whose preview should be fetched.
    x_api_key: Bearer API key from the ``x-api-key`` header.
    token_service: Injected token validation service.
    request: Raw FastAPI ``Request``.
    version: API version extracted from the ``version`` request header.

Returns:
    VoicePreviewResponse: Signed URL pointing to the preview audio clip.

## Path parameters

- `voice_id` string, uuid, required

## Headers

- `version` 'v1'
- `X-Api-Key` string

## Response `200`

Successful Response

- VoicePreviewResponse
  - `signed_url` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/async/apis/text-to-speech-api-service.md) · [All operations](https://skmtc.dev/async/apis/text-to-speech-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/async/text-to-speech-api-service/revisions/9bfc541b6e9a/schema)