Skip to main content
GET
cURL
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

Create a key in API → API Keys: select Create API key, name it in the popup, then select Create key. Copy the one-time key and send it as Authorization: Bearer mage_sk_…. Keys are for server-side code only.

Response

The balance.

gems
object
required
Last modified on September 23, 2026