provider-billing

name

provider-billing

description

Query billing, usage, credits, and resource deployments across all our cloud and SaaS providers (Azure, AWS, Cloudflare, GCP, Tinybird, Vercel, Stripe, historical Polar, etc.) via their native CLIs and APIs. Use for any question about provider costs, spend by service/day/month, credit eligibility, invoice totals, which resources are running, or how to deploy/inspect resources. Each provider has a dedicated playbook under `providers/`.

Provider billing knowledge base

This skill captures the exact CLI and REST calls needed to answer cost, usage, credit, and deployment questions for every provider we use. It is a meta-skill: the umbrella loads here, then you open the specific provider playbook from providers/<name>.md based on the question.

The goal is simple: never re-derive a billing API shape twice. Every time we learn a new gotcha — wrong param name, missing permission, weird regional naming — it gets captured in the relevant provider file.

How to use

1. Identify which provider the question is about (Azure spend? AWS Cost Explorer? Cloudflare analytics? Stripe fees?)
2. Open the matching file under providers/
3. Follow the recipes there — they are validated and commented with the date they were verified
4. If the provider file doesn't exist yet, create it by copying the template below
5. If you learn a new gotcha during the session, update the provider file before finishing

Available provider playbooks

Provider	Playbook	Status	Last validated
Azure	providers/azure.md	✅ Production	2026-04-11
AWS	providers/aws.md	✅ Production (list prices, no credits visible)	2026-04-11
Umbrella Cost (Automat-IT reseller)	providers/umbrella-cost.md	⚠️ Auth validated, data plane blocked (API access gated at tenant). Shows real invoiced AWS cost after reseller discount — supersedes aws.md for runway math once unblocked.	2026-04-11
GCP / Vertex AI	providers/gcp.md	✅ Production — auth + inventory validated live. BigQuery billing export needs one-time Console enable before SKU-level queries work.	2026-04-11
Stripe (revenue + fees)	providers/stripe.md	✅ Production — balance, balance_transactions, fees. March 2026: €7,303 gross / €6,627 net.	2026-04-11
Polar.sh (historical billing)	providers/polar.md	🗄️ Retired from runtime; read-only queries for pre-migration orders and subscriptions	2026-07-10
Wise (cash position)	providers/wise.md	✅ Production — profiles + balances live. €58,594 in business EUR balance captured. ⚠️ Statement/transaction endpoints require SCA keypair (one-time openssl setup).	2026-04-11
RunPod (GPU shadow cost)	providers/runpod.md	✅ Production — live burn rate + credit balance via GraphQL. $2,071 credit remaining, $1.648/hr burn, ~52 days runway. No historical ledger (poll to reconstruct).	2026-04-11
Lambda Labs (GPU shadow cost)	providers/lambda-labs.md	✅ Production — instances + price book live. $5.57/hr → ~$4,010/mo across 3 instances. ❌ Zero billing endpoints; shadow cost ONLY via polling + price book.	2026-04-11
Alibaba Cloud (Model Studio / DashScope)	providers/alibaba.md	✅ Production — full BSS query flow. March net $224 (after $1k coupon), April MTD $704 (coupon depleted), run rate ~$2,745/mo. Per-model breakdown via InstanceID parsing.	2026-04-11
BytePlus (Seedance + Seedream)	providers/byteplus.md	✅ Production — Model Ark /api/v3/models works, ❌ zero billing endpoints on the international tenant. Shadow cost via Tinybird generation_event; credit pool balance Console-only.	2026-04-12
Perplexity (Sonar web-search)	providers/perplexity.md	✅ Production — POST /chat/completions is the only endpoint that exists. Every billing/usage/models path returns 404. Shadow cost via Tinybird; credit pool balance dashboard-only.	2026-04-12
Fireworks AI	providers/fireworks.md	✅ Production — firectl account get for live balance, billing export-metrics for per-model CSV. $10k credit pool on pollinations account.	2026-04-12
DeepInfra	providers/deepinfra.md	✅ Production — OpenAI-compatible runtime + REST token management. Billing usage endpoints expose cents by month/token.	2026-04-24
OpenRouter	providers/openrouter.md	✅ Production candidate — /credits exposes total credits/usage; key management API supports rolling rotation.	2026-05-06
Replicate	providers/replicate.md	✅ Production candidate — single token, no public credit/balance API, no token CRUD API (UI-only). Pay-as-you-go via Wise. Per-second video pricing tiered by resolution + audio.	2026-05-07
fal.ai	providers/fal.md	✅ Auth + pricing/estimate validated live. Per-unit flat pricing (Stable Audio 2.5 t2a = $0.20/audio, shipped #11949). Authorization: Key id:secret (not Bearer). Output is a URL. No historical-usage REST endpoint confirmed (dashboard/Tinybird).	2026-06-22
Cloudflare	providers/cloudflare.md	⏳ TODO	—
Tinybird	providers/tinybird.md	⏳ TODO — two workspaces now (pollinations_enter prod + pollinations_enter_staging); billing playbook should cover per-workspace cost. See also tinybird-deploy skill for deploys.	—
Vercel	providers/vercel.md	⏳ TODO	—
Vast.ai	providers/vast.md	⏳ TODO	—
OVH	providers/ovh.md	⏳ TODO	—

What each playbook must contain

Every provider file follows the same shape so they're comparable and composable:

1. Requirements — CLI tools, auth, env vars, permissions
2. Known identifiers — account IDs, subscription IDs, billing profiles, regions (real values, not placeholders)
3. Query endpoints — one section per endpoint (realtime usage, billed transactions, invoices, quotas, credit balance)
4. Field semantics — what each response field means, especially ambiguous ones
5. Credit / discount handling — how to tell what's covered by credits, MACC, sponsorship, etc.
6. Deployment operations — how to create/list/inspect/delete resources (if the provider hosts compute/models)
7. Gotchas — every wrong-param-name / permission-denied / regional-naming quirk we've hit
8. Cheat sheet — "Question → query" table at the end
9. Known unknowns — open questions and blockers (permission grants needed, unresolved provisioning errors, etc.)

Template for a new provider

When you add a new provider playbook, copy this structure:

# <Provider> billing via CLI

Validated: <YYYY-MM-DD>. Re-validate if a command returns unexpected results.

## Requirements
- CLI: `<cli-name>` installed and authenticated
- Python3 for JSON wrangling
- Any required environment variables or credentials

## Known identifiers (our account)
<Account / subscription / project / org IDs with real values>

## Querying spend and usage

### 1. <Endpoint name> — <latency / granularity>
<exact curl or CLI command with our identifiers pre-filled>
<sample output fields with semantics>

### 2. <Next endpoint>
...

## Credit / discount handling
<How credits apply, which fields show them, permission requirements>

## Deployment operations (if applicable)
<Create / list / inspect / delete commands>

## Gotchas
- <Specific error → root cause → fix>
- <...>

## Question → query cheat sheet
| Question | Endpoint | Example |

## Known unknowns
- <Blocker 1>
- <Blocker 2>

Adding a new provider playbook

1. Create providers/<name>.md using the template above
2. Add the row to the table in this file
3. Fill in only what you validated in this session — don't guess at endpoints
4. If something is unverified, mark it ⚠️ UNVERIFIED inline so the next session knows to check it

Related skills

• spending-analysis — Pollinations revenue side (Stripe events + Tinybird usage). Pair with this skill when answering "how much did we spend vs. how much did we earn."
• tinybird-deploy — Tinybird deployment mechanics. This skill will eventually host the cost side of Tinybird.
• enter-services — enter.pollinations.ai deployment. Related for EC2 and Cloudflare Worker spend questions.