Vercel AI Gateway
Adapter key vercel. Responses, Chat Completions, embeddings, images, and reranking through Vercel AI Gateway.
{
"publicModel": "claude-through-vercel",
"adapterKey": "vercel",
"upstreamModel": "anthropic/claude-opus-5",
"credentials": { "apiKey": "..." }
}- Credentials:
apiKeyonly. The adapter useshttps://ai-gateway.vercel.sh/v1by default;baseUrlcan override it for a compatible proxy. - Model ids: use Vercel's complete
creator/modelid, such asopenai/gpt-5.6-sol,anthropic/claude-opus-5, orgoogle/gemini-3.1-pro-preview. - Text transports: Responses and Chat Completions. The public Responses and Chat endpoints prefer their matching upstream wire; the public Anthropic Messages endpoint continues through the canonical text core and uses the adapter's default Responses transport.
- Other operations: OpenAI-compatible embeddings and image generation/editing, plus the
Cohere-compatible
POST /reranktransport used internally by the public OpenRouter-shaped/v1/rerankendpoint. Audio transcription and video generation are not advertised because Vercel's current protocols do not match the transports implemented by this gateway. - Owned catalog: Vercel does not borrow a first-party provider's entry. Its committed catalog is
generated from Vercel's unauthenticated
/v1/modelsAPI, keyed by the completecreator/modelid. Limits, modalities, parameters, reasoning controls, base token pricing, and context tiers therefore describe the Vercel route rather than the creator's direct API. - Catalog coverage: the sync emits language, embedding, image, and reranking operations implemented by this adapter. It reports Vercel models whose operation families are not implemented (currently video, transcription, realtime, and speech) instead of publishing unusable catalog entries. Rerank profiles remain text-only and ambiguous zero pricing is reported rather than treated as free.
- Reasoning: Vercel's source-provided effort values are preserved exactly through its normalized
REST reasoning object;
maxandxhighare never aliases. A source toggle becomes the canonicalnone | highcontrol. Models with a reasoning tag or budget but no effort levels are described as fixed reasoners; the sync reports them rather than inventing a ladder. - Reasoning state: Chat Completions
reasoning_detailsare retained underprovider_specific_fields.vercel.reasoning_detailsand replayed when the client echoes the assistant message, preserving signatures and encrypted reasoning in tool loops. - Gateway extensions: Vercel request extensions can be supplied through the gateway's
extra_body, includingproviderOptionsandmodels. They remain provider-shaped passthrough; operators should not allow untrusted clients to submit request-scoped BYOK credentials.
What to read next
- Creating deployments — deployment fields and catalog behavior.
- Model catalog — regenerate and verify the Vercel snapshot.
- Reasoning — normalized effort levels and clamping.
- Provider-specific fields — opaque state round-tripping.
- Reranking — request semantics and Vercel/OpenRouter pooling.