Billing and top-ups

Cloakray is pay as you go from a prepaid balance, and the balance is funded with crypto. You add funds, each request is charged at the model's price for the tokens (or images, seconds, pages) it actually used, and the cost comes off the balance. There are no subscriptions, minimums or gateway fees: a top-up credits exactly the amount you pay.

The balance is kept in US dollars and belongs to the organization, so every project and every member's keys draw on it.

Add funds

Open Billing, pick an amount and continue to the checkout page:

1. Choose the coin and network you want to pay with. The checkout page lists every option and the exact amount to send.
2. Send the payment from your wallet or exchange.
3. Your balance is credited in US dollars once the payment confirms on its network. How long that takes depends on the network you chose.

Preset amounts run from $5 to $1,000, or enter any whole-dollar amount in that range. There is no card to save and no card on file.

Keeping the balance topped up

Crypto payments are sent by you, so there is no automatic top-up. Before production traffic arrives, add enough credit to cover a few days of usage, and check the balance from the console or from code (below) so a low balance never stops requests.

How requests are charged

• The price is the model's list price minus any discount on your organization, and it is the same whichever way the request was served.
• You pay for what was used: input and output tokens, cached tokens at their lower rate, and per-unit prices for images, audio, video, pages and searches.
• Every reply reports what it cost in usage.cost (usage and cost). The same figure is in your logs, and totals are in analytics.

A request needs a positive balance to start. Because the exact cost of a request is only known when it finishes, the balance can dip slightly below zero after a large one; the next top-up covers it.

When the balance is empty, requests are refused with a 402 and nothing is charged. When the balance can't be confirmed, requests are refused with a 503 rather than allowed through — retry shortly.

Payment history

The billing page lists every top-up with its amount and status. The available balance, total funded, and any payments still being confirmed are shown at the top.

Checking the balance from code

GET /v1/credits returns the balance and total spend — see authentication.