Skip to main content

Add the credential

Open Settings > Model Providers, click Add Model Provider and select Vertex AI. Give the row a name, pick the organization, team or project it belongs to, and fill in: Save the row. Every virtual key whose scope can see the row can now dispatch to it, unless the key restricts its providers. See Virtual keys.
The Vertex AI model provider drawer with GOOGLE_APPLICATION_CREDENTIALS filled in, VERTEXAI_PROJECT acme-ai, VERTEXAI_LOCATION us-central1 and the routing handle vertex_ai

The Vertex AI row: the service account JSON, VERTEXAI_PROJECT and VERTEXAI_LOCATION, all three required. The routing handle defaults to vertex_ai.

Model names

Write vertex/<model>, for example vertex/gemini-2.5-flash. vertex_ai/ is accepted as an alias. The gateway does not infer Vertex AI from a bare name. Add the models you use under Custom Models on the row.

Send a request

Endpoints

Last modified on September 6, 2026