Get Single Voice (with audioUrl)
June 5, 2026 (November 16, 2026)
Table of contents
Resolve a single voice by reference-id and return a fresh playback URL.
- System voice (e.g.
Achernar) — short-circuits to the staticsampleUrlongstatic.com. No upstream call. Instant. - User voice (encoded reference-id from POST /voices) — resolves a fresh signed
audioUrlvia Google’s media-redirect endpoint. The URL is valid for ~6 hours.
https://api.useapi.net/v1/google-flow/voices/
ref
Path Parameters
refis required, the voice to fetch. Either a system voice name (e.g.Achernar, case-insensitive) or a user voice reference-id returned by POST /voices (URL-encoded).
Request Headers
Authorization: Bearer {API token}
Responses
-
A system voice, for a system voice name such as
Achernar.{ "voice": "Achernar", "source": "system", "displayName": "Achernar", "sampleUrl": "https://www.gstatic.com/aitestkitchen/voices/samples/Achernar.wav" } -
The path segment is neither a known system voice name nor a recognized user voice reference-id.
{ "error": "Parameter voiceRef is neither a system voice name nor a recognized user voice reference-id", "code": 400 } -
The reference belongs to a different user.
{ "error": "Unauthorized access to user:12345 detected in voice reference", "code": 403 } -
The voice doesn’t exist (deleted or never created).
{ "error": "Voice not found: d990a2f9-...", "code": 404 }
Model
The voice: a system preset with its sample link, or one of your own voices with its audio link.
The system voice or custom voice, field by field
// System voice
{
voice: string // base preset name (e.g. "Achernar")
source: 'system' // a system voice preset
displayName: string // same as voice
sampleUrl: string // a static Google link
}
// User voice
{
voice: string // reference-id for subsequent calls
source: 'user' // a custom voice (POST /voices)
displayName: string // the voice's name ('Untitled Voice' when it has none)
workflowId: string // Google Flow workflow of the voice
mediaId: string // media id of the voice's audio
baseVoice?: string // system preset the user voice derives from, when Google reports it
dialog?: string // the text the voice speaks in its sample
voicePerformance?: string // the delivery style
createTime?: string // ISO 8601 timestamp
audioUrl?: string // signed playback URL (~6h TTL); occasionally absent on transient resolution failure
}
Examples
-
# System voice curl -H "Authorization: Bearer YOUR_API_TOKEN" \ "https://api.useapi.net/v1/google-flow/voices/Achernar" # User voice — URL-encode the reference! REF="user:12345-email:6a6f...-voice:d990a2f9-...-mid:d55b6d59-..." REF_ENC=$(printf '%s' "$REF" | jq -sRr @uri) curl -H "Authorization: Bearer YOUR_API_TOKEN" \ "https://api.useapi.net/v1/google-flow/voices/$REF_ENC" -
const ref = 'user:12345-email:6a6f...-voice:d990a2f9-...-mid:d55b6d59-...' const r = await fetch( `https://api.useapi.net/v1/google-flow/voices/${encodeURIComponent(ref)}`, { headers: { 'Authorization': `Bearer ${token}` } } ) const v = await r.json() console.log('audio:', v.audioUrl || v.sampleUrl) -
import requests, urllib.parse ref = 'user:12345-email:6a6f...-voice:d990a2f9-...-mid:d55b6d59-...' r = requests.get( f'https://api.useapi.net/v1/google-flow/voices/{urllib.parse.quote(ref, safe="")}', headers={'Authorization': f'Bearer {token}'}, ) v = r.json() print('audio:', v.get('audioUrl') or v.get('sampleUrl'))