Genesis Docs

Models / Providers

Vercel AI gateway

The Vercel AI Gateway provides a unified API to access hundreds of models through a single endpoint.

Property Value
Provider vercel-ai-gateway
Auth AI_GATEWAY_API_KEY
API Anthropic Messages compatible
Model catalog Auto-discovered via /v1/models

Genesis auto-discovers the Gateway /v1/models catalog, so /models vercel-ai-gateway includes current model refs such as vercel-ai-gateway/openai/gpt-5.5 and vercel-ai-gateway/moonshotai/kimi-k2.6.

Getting started

Set the API key

Run onboarding and choose the AI Gateway auth option:

genesis onboard --auth-choice ai-gateway-api-key

Set a default model

Add the model to your Genesis config:

{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

Verify the model is available

genesis models list --provider vercel-ai-gateway

Non-interactive example

For scripted or CI setups, pass all values on the command line:

genesis onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Model ID shorthand

Genesis accepts Vercel Claude shorthand model refs and normalizes them at runtime:

Shorthand input Normalized model ref
vercel-ai-gateway/claude-opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4-6

You can use either the shorthand or the fully qualified model ref in your configuration. Genesis resolves the canonical form automatically.

Jev

Vercel AI Gateway also serves TypeSafe Jev (typesafe-ai/jev), an evaluation model that cannot chat, so discovery hides it from the chat model list. The TypeSafe Jev plugin can use your AI_GATEWAY_API_KEY to reach it.

Advanced configuration

Environment variable for daemon processes

If the Genesis Gateway runs as a daemon (launchd/systemd), make sure AI_GATEWAY_API_KEY is available to that process.

A key set only in ~/.profile will not be visible to a launchd/systemd daemon unless that environment is explicitly imported. Set the key in ~/.genesis/.env or via env.shellEnv to ensure the gateway process can read it.

Provider routing

Vercel AI Gateway routes requests to the upstream provider based on the model ref prefix. For example, vercel-ai-gateway/anthropic/claude-opus-4.6 routes through Anthropic, while vercel-ai-gateway/openai/gpt-5.5 routes through OpenAI and vercel-ai-gateway/moonshotai/kimi-k2.6 routes through MoonshotAI. Your single AI_GATEWAY_API_KEY handles authentication for all upstream providers.