Gateway

Vercel AI Gateway

A routing layer in front of every major vendor.

Quick start

import polygate
 
response = polygate.chat(
    provider="vercel",
    model="anthropic/claude-sonnet-4.5",
    messages=[{"role": "user", "content": "Say hi in one word."}],
)
 
print(response.content)   # "Hi!"
print(response.usage)     # Usage(prompt_tokens=..., completion_tokens=...)

Names

Any of these work as provider. They all reach the same adapter, so pick whichever reads best in your code.

Configuration

Any of these may hold a comma-separated list. polygate rotates across them, parks a rate-limited one for its Retry-After, and drops one the provider rejects — so a key pool is configuration, not code.

Endpoint

https://ai-gateway.vercel.sh/v1

Pass base_url to point the same wire format somewhere else — a proxy, a regional endpoint, or a gateway in front of it.

Models

Addressed vendor/model. These are examples — the gateway's own catalogue is the authority.

Things worth knowing

• The environment variable is AI_GATEWAY_API_KEY rather than a Vercel-branded name, matching what Vercel's own tooling sets.

Batch

Vercel AI Gateway has no offline batch API. To run many requests at once, use map_chat — full price, but it works everywhere and returns in seconds. See Batching & concurrency.