List AI voices
The feature’s current state, every voice this account can offer (TipPage’s own, the ones this streamer cloned, and voices other streamers published), and this month’s usage. Being listed IS being offered to donors - the per-voice enable/disable calls add a voice to and remove it from this list. Voice ids are stable (voi_...). min_amount is the tip amount that unlocks AI voices on the tip page. Requires ai_voices:manage. Closed beta: answers 404 unless AI voices are enabled for your account.
/ai-voicesAuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
Feature state, catalog, and usage.
enabledbooleanThe master switch - whether donors are offered AI voices.
modestringoptional keeps the standard voice as the default; exclusive makes every tip message use an AI voice.
optionalexclusivemin_amountnumberMinimum tip amount that unlocks AI voices.
usageobjectThis month's generation, for information only - there is no monthly allowance to spend down.
Show propertiesHide properties
monthstringcharacters_spokenintegerseconds_generatednumbergenerationsintegervoicesobject[]Show propertiesHide properties
objectidstringlabelstringhintstringgenderstringmfxsample_urlstringA short sample clip of the voice.
reference_secondsintegerSeconds of reference audio behind the voice. A message is spoken in one generation and every voice in it shares that generation's budget, so these add up.
sourcestringplatform is a TipPage voice, own one this streamer cloned, shared one another streamer published.
platformownsharedMissing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the required scope (missing_scope).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
required_scopestringNo such resource.
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Rate limit exceeded - check the RateLimit-* headers.
errorstring