Get balance

GET

dashboard

billing

balance

curl https://www.qingbo.dev/v1/dashboard/billing/balance \
  -H "Authorization: Bearer $WAVE_API_KEY"

import os, requests

r = requests.get(
    "https://www.qingbo.dev/v1/dashboard/billing/balance",
    headers={"Authorization": f"Bearer {os.environ['WAVE_API_KEY']}"},
)
print(r.json()["total_available_usd"])

const r = await fetch('https://www.qingbo.dev/v1/dashboard/billing/balance', {
  headers: { Authorization: `Bearer ${process.env.WAVE_API_KEY}` }
});
const data = await r.json();
console.log(data.total_available_usd);

{
  "object": "credit_summary",
  "currency": "USD",
  "total_granted_usd": 20,
  "total_used_usd": 3.482914,
  "total_available_usd": 16.517086,
  "as_of": 1788681600
}

{
  "error": {
    "message": "missing token identity",
    "type": "invalid_request_error"
  }
}

Check your wallet with your own WaveAPI key and get all three numbers at once: available balance, usage to date and total credit. This is a self-service endpoint — no admin permission required.

The dashboard in the path is a shape kept for compatibility with existing tools, not an admin API. Call it with an ordinary Authorization: Bearer $WAVE_API_KEY.

curl https://www.qingbo.dev/v1/dashboard/billing/balance \
  -H "Authorization: Bearer $WAVE_API_KEY"

import os, requests

r = requests.get(
    "https://www.qingbo.dev/v1/dashboard/billing/balance",
    headers={"Authorization": f"Bearer {os.environ['WAVE_API_KEY']}"},
)
print(r.json()["total_available_usd"])

const r = await fetch('https://www.qingbo.dev/v1/dashboard/billing/balance', {
  headers: { Authorization: `Bearer ${process.env.WAVE_API_KEY}` }
});
const data = await r.json();
console.log(data.total_available_usd);

{
  "object": "credit_summary",
  "currency": "USD",
  "total_granted_usd": 20,
  "total_used_usd": 3.482914,
  "total_available_usd": 16.517086,
  "as_of": 1788681600
}

{
  "error": {
    "message": "missing token identity",
    "type": "invalid_request_error"
  }
}

Authorizations

string

required

Bearer YOUR_API_KEY — any key from your console works.

Response

string

Always credit_summary.

string

Always USD.

number

Current available balance in dollars. This is the number to check before deciding whether you can keep calling.

number

Usage to date in dollars, since the account was opened — not sliced by time.

number

Total credit in dollars = available balance + usage to date.

integer

Timestamp of the reading (Unix seconds).

How the numbers work

The balance belongs to the account, not to a key. A key is only an authentication unit; every key on the same account reports the same wallet.
Dollars are a conversion. The internal unit is an integer quota at 500,000 quota = 1 USD; the cost field on task and text responses is that quota, not dollars.
This endpoint returns only your own account data.

Which of the three to use

Data needed	Endpoint
Balance, usage and total credit in one request	This endpoint — recommended for new integrations
Usage to date only (OpenAI shape, in cents)	Get usage
Total credit only (OpenAI’s `hard_limit_usd`)	Get subscription

The other two keep OpenAI’s response shape so existing credit-checking tools — usage dashboards, cost-tracking scripts — work unchanged.

curl https://www.qingbo.dev/v1/dashboard/billing/balance \
  -H "Authorization: Bearer $WAVE_API_KEY"

import os, requests

r = requests.get(
    "https://www.qingbo.dev/v1/dashboard/billing/balance",
    headers={"Authorization": f"Bearer {os.environ['WAVE_API_KEY']}"},
)
print(r.json()["total_available_usd"])

const r = await fetch('https://www.qingbo.dev/v1/dashboard/billing/balance', {
  headers: { Authorization: `Bearer ${process.env.WAVE_API_KEY}` }
});
const data = await r.json();
console.log(data.total_available_usd);

{
  "object": "credit_summary",
  "currency": "USD",
  "total_granted_usd": 20,
  "total_used_usd": 3.482914,
  "total_available_usd": 16.517086,
  "as_of": 1788681600
}

{
  "error": {
    "message": "missing token identity",
    "type": "invalid_request_error"
  }
}

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Authorizations

Response

How the numbers work

Which of the three to use

​Authorizations

​Response

​How the numbers work

​Which of the three to use

​Related

Authorizations

Response

How the numbers work

Which of the three to use

Related