Pricing and invoice reconciliation
See and set the price Venom Cloud books for each model, pick where prices come from, check providers for new models and prices, and compare a provider's bill with what Venom booked.
Every request Venom Cloud serves is booked at a price per 1M input, cached input and output tokens. Usage, budgets, spend guards and chargeback all read that number. The Pricing pages show where each price comes from, let you override it, and let you check a provider's invoice against it.
| Page | What it is for |
|---|---|
/prices |
Every model the cloud serves you, its effective price and its source; the pricing source; custom prices; new models and prices. |
/prices/reconcile |
Past invoice reconciliations, newest first. |
/prices/reconcile/new |
Upload a provider's usage or cost export and compare it. |
/prices/reconcile/{id} |
One reconciliation, day by day and model by model. |
Set a custom price
- Open
/prices. - Under custom prices, add a row: the model id, then input, output and (optionally) cached input in USD per 1M tokens. Cached input left empty is the input price.
- Save. New requests book the price within 10 seconds; past requests keep the price they were booked at.
The figures at the top show how many models are served, how many are Unpriced (they book $0 and are flagged in the list), how many custom prices you have, and the pricing source.
Pricing source
| Source | Order the cloud tries |
|---|---|
| Provider's price first (default) | Your custom prices, then the price the provider's own listing gives (OpenRouter, a LiteLLM proxy), then Venom's built-in table. |
| Venom's table first | Your custom prices, then Venom's built-in table, then the provider's listing. |
| Custom only | Only your custom prices. Every other model is unpriced: it books $0 and is flagged. |
A model the cloud doesn't know by name (an Azure deployment, a self-hosted model) can be priced as a known model with "Priced as" on its provider's page (see Providers and provider keys). The list on /prices shows each model's base model and the source that priced it. Your daemons' own prices are listed below it.
New models and prices
Check for new models and prices asks each provider what it lists now, with your own keys. Nothing is fetched before you click and nothing changes until you accept a row. Per key it shows:
- new models, with their capabilities and price;
- models that were removed or are retiring;
- listed prices that differ from what the cloud books;
- unpriced models to map to a base model.
Accept rows one at a time, or Save this listing to mark the rest as seen. A platform operator also sees Venom's own price table against the providers' listings.
Reconcile an invoice
Export last month's usage or costs from the provider's console (OpenAI and Anthropic exports are recognised; any CSV with a date, a model and dollars or tokens works through a column mapping), then:
- Open
/prices/reconcile/new(Reconcile an invoice on/prices). - Pick the provider key (or every key of that provider) and the period.
- Add the file or files. The browser reads them; only the summed rows go to the cloud, and the file is never stored.
- Check how the columns were read, change any mapping, and Compare.
The result at /prices/reconcile/{id} compares the provider's figures with what Venom booked, per UTC day and model: requests, tokens, cached tokens and dollars, the delta, and why rows differ, most likely cause first (an unpriced model, usage outside Venom on the same key, cache writes, batch or flex rates, estimates for streams that broke, a day boundary, a non-model charge). For a flagged model, Set custom price adds the suggested price to your custom prices. You can recompute with a new threshold, download the comparison as CSV, or delete it.
| Rule | Value |
|---|---|
| Flag threshold | Venom's dollars more than 5% off the provider's (default; changeable per reconciliation) and at least $0.01 apart. Tokens are compared when the export has no dollars |
| Files | at most 4, 5 MB each |
| Lines | at most 200,000 per file, 200 columns, 4,096 characters a cell |
| Day × model rows | at most 20,000 |
| Currency | USD rows only; others are skipped and counted in the notes |
| Matching | normalised model ids (gpt-4o-2024-08-06 matches gpt-4o), then the base model Venom priced them as |
Venom's side is the requests the cloud itself served through the picked key. It is kept with the reconciliation, because the request log ages out.
Who can do what
| Action | Permission | Roles |
|---|---|---|
See /prices |
providers:read |
owner, admin, developer, viewer |
| See reconciliations | usage:read |
owner, admin, developer, billing, viewer |
| Change the pricing source and custom prices; accept catalog rows; create, recompute and delete reconciliations; Set custom price | providers:write |
owner, admin |
Troubleshooting
| Message | Cause and fix |
|---|---|
| Your role cannot change prices (providers:write). | Ask an owner or admin. |
| Pick an organisation first. | A platform operator must choose an org in the switcher. |
| Too many rows for one reconciliation: pick a shorter period. | Export fewer days. |
Over 20,000 day × model rows: export a shorter period. |
Same. |
| The file is over 5 MB. | Split the export by month or provider key. |
| The rows did not arrive whole. Read the file again. | Upload the file again. |
| Every row flagged, provider counts more tokens | The key is also used outside Venom. Use a key only Venom uses, or filter the export by key column. |
Related
- Providers and provider keys: keys, models and "Priced as".
- Budgets and Usage and chargeback: what reads these prices.