Skip to main content
GET
Get Voice Sample

Overview

Returns a single training sample for a voice you own. By default the response is the raw WAV audio. Pass ?format=json to get the metadata plus base64-encoded audio instead. Only voices owned by your org return samples. Default voices and shared-library voices return 400 VOICE_SAMPLE_ERROR.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

id
string
required
UUID of the parent voice.
sample_id
string
required
UUID of the sample to fetch.

Query Parameters

format
string
default:"audio"
Response format. audio returns the raw WAV binary, json returns sample metadata with base64-encoded audio under data.

Response

With format=audio (default), returns the WAV binary with:
  • Content-Type: audio/wav
  • Content-Disposition: attachment; filename="sample-<id>.wav"
With format=json, returns sample metadata.
sample
object
Only present in JSON mode.

Docs for agents: llms.txt