Skip to main content
GET
Get account
The gems balance the API’s generations draw from. A generation whose price exceeds the balance is refused with 402 insufficient_gems and gems_required. If auto top-up is on for the account, an API request can trigger it exactly as a generation in the app would.

Authorizations

Authorization
string
header
required

An API key from Settings → API, sent as Authorization: Bearer mage_sk_…. Keys are for server-side code only.

Response

The balance.

gems
object
required
Last modified on September 17, 2026