---
search:
  tags:
    - TTS queue
    - GET
seo:
  description: >-
    The clip for a queued tip, made on demand. A standard-voice tip's audio is…
    Reference for the GET /tts/{orderId}/audio endpoint in the TipPage Developer
    API.
sidebar:
  label: Audio for a tip
  badge: GET
title: Audio for a tip
type: openapi-operation
---
The clip for a queued tip, made on demand. A standard-voice tip's audio is only made when something comes to play it, so a consumer that plays tips itself asks here before or after claiming; an AI-voice tip's clip was made at payment and is handed straight back. The words come from the row's current name, amount and message. The clip you are handed is written to the queue row as `tts_url` and fires `tip.tts_ready` (again if it replaces an earlier clip in another voice, such as a dashboard preview).

Say whose voice to read it in: `overlay` for that overlay's alert box voice, or `voice` for a standard voice. Passing neither is deprecated: it reads in Brian for now and will become `400 voice_required`. Other voice parameters given directly override the overlay's. A tip that has already played can be asked for too: you get the clip that played, whatever voice you name (one that played with no audio is made now). No rate limit; up to 8 distinct voice variants per tip. The same parameters are accepted in a JSON body on POST. Requires `tts:read`.

`GET /tts/{orderId}/audio`

**Responses**

- `200` — One of: the clip (\`url\`, with \`text\` for a standard tip or \`ai\` for an AI-voice tip), \`pending\` (an AI voice is still being made, ask again after \`retryMs\`), or \`silent\` (nothing of this tip is read with these settings).
- `400` — A voice parameter is out of range or names no standard voice. Later also \`voice\_required\` (neither \`overlay\` nor \`voice\` was given).
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `403` — The key lacks the required scope (\`missing\_scope\`).
- `404` — \`tip\_not\_found\` (no tip of yours has that id) or \`overlay\_not\_found\` (no overlay of yours with an alert box has that id).
- `429` — \`too\_many\_variants\`: the tip has been asked for in too many different voices.
- `503` — Every synthesiser failed. \`text\` carries the words, for a voice of your own.

Response example, 200:

```json
{
  "url": "http://example.com",
  "text": "string",
  "cached": true,
  "provider": "string",
  "ai": {
    "voiced": true,
    "turns": [
      {}
    ]
  }
}
```
