vercel ai-gateway leaderboard models exposes model usage rankings

Introduced 2026-07-28 · score 0.99

HOW TO USE IT

When reviewing AI Gateway model usage, run the leaderboard command to view rankings; filter by modality, metric, or date, and choose an output format or file. [Vercel CLI source](https://github.com/vercel/vercel/blob/vercel%4058.1.0/packages/cli/src/commands/ai-gateway/command.ts)

WHY THIS HELPS

Inspect AI Gateway model usage data from the CLI when reviewing a repository's gateway usage.

REQUIREMENTS AND LIMITATIONS

• Version: 58.1.0
• --modality <MODALITY>: Filter: all, text, image, or video; default all.
• --metric <METRIC>: Table metric: requests, tokens, spend, imageCount, or videoCount; default requests.
• --date <YYYY-MM-DD>: Day shown in the table; default most recent.
• --format <FORMAT>: Output format: table, json, or csv. Defaults to table in a terminal and json otherwise.
• --out <FILE>: Write payload to a file instead of stdout; defaults to json, or use --format csv for CSV.
• Prerequisite: Use Vercel CLI 58.1.0 or later; the command is present in the 58.1.0 source and introduced in that release.
• Interactive terminals display a pretty table; piped output defaults to JSON.

FIRST-PARTY EVIDENCE

• https://github.com/vercel/vercel/releases/tag/vercel%4058.1.0
• https://github.com/vercel/vercel/blob/vercel%4058.1.0/packages/cli/src/commands/ai-gateway/command.ts

Check the installed version and the source before using it. Entry JSON

Report a problem with this card