Genesis Docs

Models / Providers

Cloudflare AI gateway

Cloudflare AI Gateway sits in front of provider APIs and lets you add analytics, caching, and controls. For Anthropic, Genesis uses the Anthropic Messages API through your Gateway endpoint.

Property Value
Provider cloudflare-ai-gateway
Base URL https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic
Default model cloudflare-ai-gateway/claude-sonnet-4-6
API key CLOUDFLARE_AI_GATEWAY_API_KEY (your provider API key for requests through the Gateway)

For Anthropic models routed through Cloudflare AI Gateway, use your Anthropic API key as the provider key.

Getting started

Set the provider API key and Gateway details

Run onboarding and choose the Cloudflare AI Gateway auth option:

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

This prompts for your account ID, gateway ID, and API key.

Set a default model

Add the model to your Genesis config:

{
  agents: {
    defaults: {
      model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-6" },
    },
  },
}

Verify the model is available

genesis models list --provider cloudflare-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 cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"

Advanced configuration

Authenticated gateways

If you enabled Gateway authentication in Cloudflare, add the cf-aig-authorization header. This is in addition to your provider API key.

{
  models: {
    providers: {
      "cloudflare-ai-gateway": {
        headers: {
          "cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
        },
      },
    },
  },
}

The cf-aig-authorization header authenticates with the Cloudflare Gateway itself, while the provider API key (for example, your Anthropic key) authenticates with the upstream provider.

Environment note

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

A key sitting only in ~/.profile will not help a launchd/systemd daemon unless that environment is imported there as well. Set the key in ~/.genesis/.env or via env.shellEnv to ensure the gateway process can read it.