OpenRouter Provider

OpenRouter is exposed as a named preset over SwarmVault's OpenAI-compatible adapter. It provides access to models from multiple providers through a single API.

Configuration

{
  "providers": {
    "primary": {
      "type": "openrouter",
      "model": "openai/gpt-4o-mini",
      "headers": {
        "HTTP-Referer": "https://www.swarmvault.ai",
        "X-Title": "SwarmVault"
      }
    }
  }
}

Options

Field	Default	Description
`model`	--	Model ID in `provider/model` format (e.g., `openai/gpt-4o-mini`, `anthropic/claude-sonnet-4`)
`apiKeyEnv`	`"OPENROUTER_API_KEY"`	Environment variable for API key
`baseUrl`	`https://openrouter.ai/api/v1`	API base URL
`apiStyle`	`"chat"`	API style (`chat` for Chat Completions)
`headers`	--	Additional HTTP headers (see notes below)
`capabilities`	--	Override auto-detected capabilities

Environment Variable

export OPENROUTER_API_KEY=sk-or-...

Notes

Model naming: OpenRouter uses the provider/model format. Check the OpenRouter models page for available model IDs.
Required headers: OpenRouter recommends sending HTTP-Referer and X-Title headers for ranking and display on their leaderboard. Add them in the headers field.
Routing: You can use provider-specific models (e.g., openai/gpt-4o) or let OpenRouter route automatically with model aliases.