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 only breaks results down by one dimension per request — day, or model, but not both together in a single call. To avoid making hundreds of calls on every sync (each one is separately metered on Vercel's side), TokenFront fetches the day-by-day totals and the whole-period model split separately, then works out each day's per-model split by combining the two. That means per-model dollar and token figures are a very close estimate rather than an exact per-day count straight from Vercel — the day-level totals themselves are always exact. Per model, per API key breakdown isn't available for the same reason and isn't currently pulled in.
If the connection shows "Key Error"
Most often this means the key is wrong, revoked, or your Vercel team is still on the Hobby plan — double-check both under Edit.