Skip to content

Bill file import ​

中文 Docs

A bill export downloaded from a provider's console parses into the same ledger rows a fetch produces. Downstream — totals, charts, alerts, attribution — an imported month is indistinguishable from a fetched one. It is often the finer reading: Alibaba Cloud's billing API reports Model Studio (百炼) as one figure a month, while its export reports it per model, with token counts.

Volcengine, OpenAI and Anthropic are import-only for now: add the account with a name, no credentials, and import.

SourceWhere the export comes fromWhat it adds
Alibaba CloudExpenses and Costs → Bill Details → ExportModel Studio (百炼) per model; instance-level detail for everything else
VolcengineBilling → Bill Details → ExportArk (火山方舟) per endpoint and token type
OpenAIUsage → ExportCost or token usage, per project and model
Anthropic (Claude)Usage or Cost → ExportCost or token usage, per workspace and model
DeepSeekUsage → DownloadPer-day, per-model spend — its API reports only a balance

Importing ​

  1. Download the export from the provider's console.
  2. Go to Accounts and click Import on the account's row.
  3. Pick the file. CloudBridge reports how many charges it wrote and which months it replaced.

A month is replaced, not added to

An import replaces every month the file covers for the selected account, so importing twice never doubles a charge. Export the full bill: a product-filtered file replaces that month's data with only that product. To update an imported month, re-import a complete, corrected export. Refresh never overwrites an imported month, Force Refresh included.

Usage exports carry no money ​

A usage export, with token counts but no amounts, is recorded with no billed cost and a cost basis of absent. CloudBridge does not turn token counts into estimated spend at list prices. A cost export keeps a quantity only where exactly one token column is populated: input and output tokens have different prices and cannot be one priced quantity.

Encodings ​

Text exports must be UTF-8. Alibaba Cloud and Volcengine consoles can produce GBK files; re-export as UTF-8 or save as CSV UTF-8 first. More in Troubleshooting.

Released under the MIT License.