
The Billing tab shows your API billing status, what your invoice includes, the Gateway spending cap, API invoices, and the cancel option.
Before you start
- You need to be an organization admin. Only admins see API in the settings sidebar.
- Your organization needs an active paid Chat plan: Pro, Power, or Enterprise. The Free plan and trials don’t qualify. A Chat plan with an overdue payment doesn’t qualify either.
- Keys need active API billing. You can create keys only after API billing shows Active. See API keys.
Enabling API billing
Open the Billing tab
Start checkout
Add your payment and billing details
- Checkout uses the same billing account as your Chat plan. A name, address, or VAT ID you change or add here also applies to your Chat plan’s billing.
- Checkout creates a separate API subscription.
- You aren’t charged at checkout. You’re first charged for usage after the current month ends.
Return to DeepMask
What you pay
Your monthly API invoice shows one usage charge: the model costs of your requests plus a 3% fee. The fee isn’t billed as a separate line. VAT is added on top where applicable, based on the billing address and VAT ID on your billing account. The API billing card on the Billing tab sums this up: “Your monthly invoice includes model costs plus a 3% fee, plus VAT where applicable.” Other parts of the API page, such as the Usage tab and the spending cap fields, call it tax. To change your billing address or VAT ID after checkout, contact support. The usage charge is calculated like this:What is and isn’t charged
Charged:- Requests that complete, for the input and output tokens they use.
- Requests where your app disconnects or times out after DeepMask sent the request to the model. The request still completes on DeepMask’s side and is billed like any other.
- Usage that the provider still reports later for a request with an unclear outcome. It’s billed like any other usage.
- Requests DeepMask refuses before they reach a model. Examples are an invalid or revoked key, a model the key can’t use, an invalid request or image, a rate limit, or a reached spending cap.
- Requests where your app disconnects before DeepMask sends the request to the model.
- Requests the model provider rejects as invalid before producing output, such as a prompt longer than the model’s context window or an image the provider can’t process.
- Requests with an unclear outcome, where DeepMask can’t tell whether the request finished. Examples are a server error or timeout at the model provider, a stream that breaks off midway, and a request that reaches the 15-minute limit. An unclear outcome doesn’t pause your organization’s requests on its own.
Invoice timing
Your API billing period follows the calendar month in UTC. The first period runs from the day you enable billing to the end of that month. After that, each period covers one full month. Shortly after each period ends, DeepMask issues the invoice for that period. It covers that period’s model costs and the 3% fee, plus VAT where applicable. The invoice is charged automatically to the payment method you added at checkout. If that payment fails, see If a payment fails. To see the current month’s total before the invoice arrives, check the Monthly API charges card on the Usage tab. It includes the 3% fee and excludes VAT. See Usage and logs.Invoices
The Invoices list on the Billing tab shows your API invoices only. Invoices for your Chat plan stay under Billing in the settings sidebar. Each row shows the invoice date, its status, and the amount. Statuses are Paid, Open, Uncollectible, Void, and Draft. A new invoice shows Draft for about an hour after the period ends, until it’s finalized.- Click Pay invoice to pay an open invoice that still has an amount due.
- Click View invoice to see any other finalized invoice. Draft invoices have no link until they’re finalized.
- An invoice marked Uncollectible that still has an amount due must be paid before API access returns. Click View invoice and pay it on the invoice page. If you can’t pay it there, contact support.
API billing status
The API billing card shows the status of your API subscription. Your keys can serve requests only while the status is Active.If a payment fails
If a payment on an API invoice fails, DeepMask pauses API access until the invoice is paid. You see the following:- The notice “An API invoice payment failed. Pay your unpaid API invoices to restore access.” with a View invoices button.
- Keys show Inactive. They aren’t revoked.
- You can’t create new keys.
- API requests are refused. A failed payment usually moves the API subscription to Past due or Unpaid, so requests get
API_SUBSCRIPTION_INACTIVE(HTTP 403). While the subscription is still Active, they getAPI_PAYMENT_FAILED(HTTP 402).
Open your invoices
Pay each open invoice
Check that access is back
Canceling API billing
Find the cancel option
Confirm
- Your keys keep working until the period ends, and you pay for what they use until then.
- The API billing card shows “API billing ends at the end of this billing period.” with a Keep API billing button. The same notice appears on the other tabs.
- When the period ends, the status changes to Canceled and your keys show Inactive. Requests are refused with
API_SUBSCRIPTION_INACTIVE. - After the period ends, you get a final invoice for that period’s usage.
- Your keys aren’t revoked. If you enable API billing again later, they work again.
- Your Chat plan isn’t affected.
Keeping API billing
Changed your mind? Click Keep API billing before the period ends. A confirmation reads “API billing continues.” and nothing else changes. After the period has ended, Keep API billing is no longer available. Click Enable API billing to go through checkout again.If your Chat plan changes
API access depends on your Chat plan. It pauses right away if your organization’s Chat plan ends and the organization moves to the Free plan, or if a Chat payment fails. If you cancel your Chat plan, API access continues until the Chat plan ends. While API access is paused:- The notice “API access needs an active paid Chat plan.” appears with a Chat billing link.
- Keys show Inactive, and you can’t create new ones.
- API requests are refused with
API_SUBSCRIPTION_INACTIVE(HTTP 403). - If API billing isn’t set up yet, Enable API billing is disabled.
Account notices
The top of the API page shows at most one account notice, the most urgent one. The table lists them from most to least urgent.FAQ
Is API usage included in my Chat plan?
Is API usage included in my Chat plan?
Is there a minimum or fixed monthly fee?
Is there a minimum or fixed monthly fee?
Do API invoices include VAT?
Do API invoices include VAT?
Am I charged when I enable API billing?
Am I charged when I enable API billing?
Does the Gateway spending cap limit my invoice?
Does the Gateway spending cap limit my invoice?
Why doesn't the Usage tab total match my invoice?
Why doesn't the Usage tab total match my invoice?
Can I use the API during a Chat trial?
Can I use the API during a Chat trial?
What happens to my keys when I cancel?
What happens to my keys when I cancel?