---
title: "Get Voice Prompt Audio"
method: GET
path: "/voices/prompt-audio/{voice_id}"
tags: ["Synth Voices"]
---

# Get Voice Prompt Audio

`GET /voices/prompt-audio/{voice_id}`

## Request

- Base URL: `https://api.async.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.async.com/voices/prompt-audio/{voice_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/async/apis/text-to-speech-api-service/docs/voices/prompt-audio/:voice_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Download the original prompt audio for a voice from GCS.

Retrieves the preset row from the ``voice_presets`` PostgreSQL table using the
preset_id resolved from PostgreSQL, reads the ``prompt_audio_gcs_uri`` field (format
``<bucket>/<filename>``), downloads the file from GCS, and returns the raw audio
bytes with an appropriate ``Content-Type`` header derived from the file extension.

Args:
    voice_id: UUID of the voice whose prompt audio should be fetched.
    model_version: AI model version used to resolve the preset_id (default
        ``async_flash_v1.0``).
    x_api_key: Bearer API key from the ``x-api-key`` header.
    token_service: Injected token validation service.
    request: Raw FastAPI ``Request``.
Returns:
    Response: Raw audio bytes with ``Content-Disposition`` attachment header.

Raises:
    VoicePreviewNotFound: When no preset exists for the voice/model combination,
        or when the preset document has no ``prompt_audio_gcs_uri`` field.

## Path parameters

- `voice_id` string, uuid, required

## Query parameters

- `model_version` 'async_flash_v1.0' | 'async_flash_v1.5' | 'async_pro_v1.0'

## Headers

- `X-Api-Key` string

## Response `200`

Successful Response

## 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.dev/async/apis/text-to-speech-api-service/revisions/9bfc541b6e9a?raw)