Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Create an OpenRouter account: Go to https://openrouter.ai and sign up or sign in. Some models offer free variants for testing; paid models require purchasing credits under Settings → Credits.
  2. Create an API key: Open https://openrouter.ai/settings/keys, click ‘Create Key’, and optionally set a credit limit for the key.
  3. Store the key: Copy the key and add it to your .env file as OPENROUTER_API_KEY=sk-or-…
  4. Verify access: Run the List Models tool to confirm the key works, then try a chat completion with a model like openai/gpt-4o-mini.
  • Model IDs are namespaced as vendor/model, e.g. anthropic/claude-sonnet-4
  • Chat completions consume prepaid credits; use the Get Generation tool to inspect the exact cost of a request
  • The Get Credits endpoint requires a management key per OpenRouter’s docs - a regular inference key may be rejected there
Provider API reference: https://openrouter.ai/docs/api/reference/overview

Tools

Example prompts

  • List the models available through OpenRouter and highlight a few with large context windows.
  • Use OpenRouter to send the same prompt to two different models and compare the responses.