Unified reporting for all AI Gateway usage
By Steven Van ·
The beta Custom Reporting API, for Pro and Enterprise teams, breaks down AI Gateway cost and usage by model, user, tag, provider, or credential type.
Vercel's AI Gateway has a new beta feature: the Custom Reporting API, which gives Pro and Enterprise teams programmatic access to cost, token usage, and request volume across all AI Gateway traffic, including BYOK (bring-your-own-key) requests.
The API breaks down spend and usage by:
- Model, to compare cost efficiency across providers
- User, to see who is driving the most spend and token consumption
- Custom tags, for attributing costs by feature, environment, or team
- Provider, when multiple providers serve the same model
- Credential type, to separate BYOK requests from system credentials
To use it, requests need a user ID and/or tags attached, either through the AI SDK, Chat Completions, Responses, OpenResponses, or Anthropic Messages APIs, or via the ai-reporting-tags and ai-reporting-user HTTP headers (up to 10 tags per request). Reporting is priced at $0.075 per 1,000 tag/user ID writes and $5 per 1,000 queries, and the API can also be queried live through Claude Code. It's currently scoped to the whole account, so any API key returns usage data for everything on it.