Guide
Configure Onyx to use models served through Vercel AI Gateway.Vercel AI Gateway exposes models from many vendors behind one OpenAI-compatible endpoint.
Onyx lists the models available to your gateway key.
1
Set Up Your Vercel AI Gateway Access
In your Vercel dashboard, open AI Gateway and create an API Key.
2
Navigate to Language Models
Open the Admin Panel from your user profile icon, then open Language Models.
3
Connect Vercel AI Gateway
Under Gateways & Routers, click Connect on the Vercel AI Gateway card.Keep the default API Base URL (
https://ai-gateway.vercel.sh/v1) or paste a custom base URL.Paste your Vercel AI Gateway API Key.4
Load Your Models
In the Models section, click Refresh models. Onyx lists the models that Vercel AI Gateway exposes.
5
Choose Visible Models
In the Models section, select the models that users can pick in chat. If a model is missing,
open More Models or type its name and click Add Model.Limiting visible models helps when a provider publishes many models and versions of the same model.
6
Set Models Access
Under Models Access, choose All Users & Agents or Named Groups & Agents.With Named Groups & Agents, only Admins and the User Groups and Agents you name can use the models.
Named groups need a Business plan or higher.
7
Connect
Click Connect. Onyx tests the provider with one of the selected models before it saves it.