Credits

OpenDunes accounts are prepaid. You deposit Algerian Dinars (DA) via SATIM — CIB or Edahabia card — and the balance is deducted per request based on token usage.

Balance units#

Balances are stored in micro-DA: 1 DA = 1,000,000 micro-DA (bigint — no floats). The credits API returns DA values derived from those integers.

Read your totals#

const res = await fetch("https://opendunes.com/api/v1/credits", {
  headers: { Authorization: `Bearer ${process.env.OPENDUNES_API_KEY}` },
});
const { data } = await res.json();

console.log(`Deposited: ${data.total_credits} DA`);
console.log(`Spent:     ${data.total_usage} DA`);
console.log(`Remaining: ${data.total_credits - data.total_usage} DA`);

GET /api/v1/credits returns:

Real-time header#

Every successful inference response also carries:

X-Balance-Available: 4820000

That is the remaining balance in micro-DA after the current request was deducted. Reading this header is the fastest way to keep a live balance display without a separate API call.

// .withResponse() exposes the raw HTTP response alongside the parsed body
const { data, response } = await client.chat.completions
  .create({ ... })
  .withResponse();

const remaining = Number(response.headers.get("x-balance-available") ?? 0);
const da = remaining / 1_000_000;

Low-balance handling#

When a request would exceed the available balance, the API returns HTTP 402:

{ "error": "insufficient_credits", "message": "Your balance is too low. Deposit DA to continue." }

Catch this and redirect your user to deposit at /dashboard/billing.

How pricing works#

Each request costs (input_tokens × input_rate) + (output_tokens × output_rate), rounded up to the nearest micro-DA (minimum 1). Rates are shown on each model's page in DA per million tokens