API Reference

Open an account, with its credit account and a first API key.

Exchange email and password for a JWT.

Read the current account: {user, orgs:[{orgId,name,role}]}.

List personal API keys, or an organization’s with orgId.

Create keys with {name, orgId?, expiresAt?, monthlyQuotaCredits?, allowedModels?, quantity?}. A key belongs to the personal account by default; name an organization and its usage is charged to that organization’s shared balance. allowedModels takes exact catalog model ids and vendor/* wildcards (omit it, or pass ["*"], for every model); any other model is refused with 403 model_not_allowed. A quantity above one returns {data:[…]}. This response is the only time a key’s secret is shown.

Rename, disable or re-enable a key, or change its expiry, quota or allowed models.

Revoke one of the caller’s API keys.

Create an organization with {name}; the creator becomes its owner.

List the organizations the caller belongs to, with their role.

List an organization’s members; the caller must be one.

Add an existing user with {email, role}; owner or admin only.

List the enabled models this key may call, their providers and customer prices.

The same catalog for a signed-in session, which the console browses.

Create an OpenAI-style chat completion, streaming over SSE if asked.

Create a top-up intent with {amount, currency?, orgId?}; the personal account by default.

Receive the billing provider’s callback.

Read the personal balance. A JWT may pass orgId for an organization’s; an organization’s API key reads its own.

Summarize usage over a period, for the personal account or an organization.

List invoices, personal or for an organization.

Generate an invoice for a period with {from, to, orgId?}.

Apply to become a reseller; the application starts pending.

Create a referral code (approved resellers): 4–32 letters, digits, - or _, unique regardless of case.

List the caller’s codes and how many users each referred.

List accrued or paid commissions.

Status, rate, referred users and commission totals.

List resellers with their referrals and commission.

Approve, suspend or reject, and set the rate: {status?, commissionPct?}.

Record that the accrued commission was paid: Idempotency-Key header, {amountCredits, reference?}.

List a reseller’s payouts and who recorded them.

Create a provider.

List providers.

Update a provider.

Create a model.

List models.

Update a model.

Attach a provider deployment to a model.

List a model’s deployments.

Add a pricing period for a model.

List a model’s pricing periods.

Search and paginate platform users.

Set a user’s status: {status:"active"|"suspended"}.

Adjust a user’s credits: {amount, reason?}.

List every organization.

Enable or disable an organization: {status:"active"|"disabled"}. A disabled organization’s keys are refused and it cannot be managed.

Adjust an organization’s shared credits: {amount, reason?}.

Platform statistics over a number of days.

List invoices, optionally filtered by status.

Receivables, totalled per user.