Appearance
Connecting Vercel AI Gateway
What you need
An AI Gateway API Key from your Vercel team. Unlike some other platforms, Vercel doesn't have a separate read-only key type — this one key can both read usage data and make real, billable AI calls through the gateway. Create a key specifically for TokenFront rather than reusing one that's already wired into a production app, so it's easy to revoke on its own if you ever need to.
This also requires your Vercel team to be on a Pro or Enterprise plan. The usage-reporting data TokenFront reads isn't available on the free Hobby plan, even though Hobby teams can still make Gateway requests and see spend in the dashboard.
Step 1: Create an API key in Vercel
- Go to AI Gateway → API Keys in your Vercel dashboard.
- Click Create key.
- Give it a name you'll recognize later — "TokenFront" works.
- Copy the key immediately. It won't be shown again.
- Optional but recommended: set a spend budget on the key while you're there, so it can't run up an unexpected bill even if it were ever misused.
Step 2: Add it to TokenFront
- Open Connect Vercel AI Gateway in TokenFront.
- Paste the key into the AI Gateway API key field.
- Save.
What TokenFront actually pulls
Vercel's usage-reporting API breaks results down by one dimension per request: day, or model, but not both at once. On each sync TokenFront asks for the daily totals, the list of models used, and then each model's own daily figures, so per-model dollars and tokens come straight from Vercel. To keep the number of requests down, only your 25 highest-spend models are fetched one by one; spend on any others is shown on an "Other models" line for that day. The day totals are always exact. Spend per API key isn't pulled.
What syncing costs you on Vercel's side
Vercel charges for its usage-reporting API. Its published price is $5 per 1,000 queries (as of October 2026), billed by Vercel to your team, not by TokenFront. Every sync makes these queries with your key:
- 2 queries, plus 1 for each model you used in the period, up to 27 in all.
- Syncs run automatically several times a day (about 5 on a typical day), and also when you press Sync now or Test connection, or open the dashboard after the data has gone stale. The first sync, the check when you save the key, and editing the key each run one too.
| Models used | Queries per sync | Rough monthly cost |
|---|---|---|
| 1 | 3 | about $2 |
| 5 | 7 | about $5 |
| 10 | 12 | about $9 |
| 25 or more | 27 | about $20 |
These are estimates at about 5 syncs a day. Manual syncs add to them, and Vercel can change its price. Vercel's invoice is the authoritative figure. TokenFront's plans don't include or reimburse these charges. To stop them, pause or delete the connection.
If the connection shows "Key rejected"
Most often this means the key is wrong, revoked, or your Vercel team is still on the Hobby plan — double-check both under Edit.
More about Vercel AI Gateway in TokenFront
What TokenFront shows for Vercel AI Gateway, and how it fits with your other providers: Vercel AI Gateway on tokenfront.io.