Get Single Voice (with audioUrl)

June 5, 2026 (November 16, 2026)

Table of contents

  1. Path Parameters
  2. Request Headers
  3. Responses
  4. Model
  5. Examples
  6. Try It

Resolve a single voice by reference-id and return a fresh playback URL.

  • System voice (e.g. Achernar) — short-circuits to the static sampleUrl on gstatic.com. No upstream call. Instant.
  • User voice (encoded reference-id from POST /voices) — resolves a fresh signed audioUrl via Google’s media-redirect endpoint. The URL is valid for ~6 hours.

https://api.useapi.net/v1/google-flow/voices/ref

Path Parameters

  • ref is 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

  • 200 OK

    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"
    }
    
  • 400 Bad Request

    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
    }
    
  • 403 Forbidden

    The reference belongs to a different user.

    {
      "error": "Unauthorized access to user:12345 detected in voice reference",
      "code": 403
    }
    
  • 404 Not Found

    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'))
    

Try It