Skip to main content

​
At a glance

​
Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
OPENROUTER_API_KEYYesOpenRouter API key (starts with sk-or-) Docs.

​
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

ToolAccessDescription
List ModelsReadList the models available through OpenRouter
Create Chat CompletionWriteGenerate a chat completion from any OpenRouter model
Get GenerationReadGet metadata, token counts, and cost for a past generation by ID
Get Current KeyReadGet the current API key’s label, credit usage (total/daily/weekly/monthly in USD), spend limit, remaining limit, and free-tier status - works with the regular inference key
Get CreditsReadGet total credits purchased and used for the account (OpenRouter requires a management key for this endpoint)

​
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.