Check balance

GET /v1/balance returns the balance owned by the supplied API key. It accepts no user or account selector, calls no image service, and costs nothing.

curl https://api.dreamlayer.io/v1/balance \
  -H "Authorization: Bearer $DREAMLAYER_API_KEY"

{
  "promotional": 0,
  "purchased": 58,
  "available": 58,
  "credit_usd": "0.17"
}

The snapshot is serialized with credit reservation, settlement, and restoration. Balances cannot be negative. Responses use Cache-Control: private, no-store, Pragma: no-cache, and Vary: Authorization, so shared caches must not retain one account’s balance. Use available to decide whether to start a one-credit image request. Other account, rate, spend, or concurrency limits can still refuse a submit. Handle the documented error contract on every request.

Start

DreamLayer Agent API

Command line and agents

Project

Endpoint reference

Check balance

Check balance

​Check balance

Check balance