Read balances | Llynx Speech API

import os
import requests
response = requests.get(
    "https://api.llynx.io/v2/audio/credits",
    headers={"Authorization": f"Bearer {os.environ['LLYNX_API_KEY']}"},
)
response.raise_for_status()
balances = response.json()
print(balances["stt"]["available"], "STT credits,", balances["tts"]["available"], "TTS credits")

{
  "stt": {
    "credit_unit": "stt_credit",
    "allocated": 6100,
    "used": 12.5,
    "reserved": 0.75,
    "available": 6086.75,
    "transcribed_seconds": 250,
    "generated_seconds": 0,
    "input_characters": 0,
    "seconds_per_credit": 20,
    "available_seconds": 121735
  },
  "tts": {
    "credit_unit": "tts_credit",
    "allocated": 5100,
    "used": 3.29,
    "reserved": 0,
    "available": 5096.71,
    "transcribed_seconds": 0,
    "generated_seconds": 41.2,
    "input_characters": 329,
    "characters_per_credit": 100,
    "available_characters": 509671
  },
  "billing_hold": false,
  "as_of": "2026-10-18T21:30:00Z"
}

Reads your remaining prepaid credit.

Call it before sending a batch of work, to decide when to buy a pack, or to show usage to your own users. Speech-to-text and text-to-speech balances are independent and reported separately, with the seconds and characters they still cover. billing_hold is true when a payment problem is blocking requests on the account. Negative balances after refunds remain visible.

Authentication

AuthorizationBearer

Your Llynx API key, sent as Authorization: Bearer <key>.

Response

Current balances for both services

sttobject

ttsobject

billing_holdboolean

True when a payment problem is blocking requests on the account.

as_ofdatetime

Time of this snapshot.

Errors

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error