🧭 wrouter-provider

Point any OpenAI-compatible client at WRouter and get 40+ providers behind one key.

WRouter is an AI API gateway that speaks the OpenAI API and proxies to 40+ upstream providers (OpenAI, Claude, Gemini, Azure, AWS Bedrock, …). You keep one base URL and one token; WRouter handles routing, billing, and rate limiting.

The token is not your account password and not a browser session — create a dedicated API token on the Tokens page and copy the full sk-… string.

1. Configure the credential

Store the token once (never hard-code it in a workflow or commit it):

mkdir -p ~/.config/wrouter
printf 'WROUTER_BASE_URL=%s\nWROUTER_API_KEY=%s\n' "https://wrouter.ai/v1" "sk-REPLACE_ME" > ~/.config/wrouter/credentials
chmod 600 ~/.config/wrouter/credentials

2. Discover available models

Never guess model IDs — ask the gateway. Your account/token determines what is enabled.

scripts/wrouter.sh models          # lists model IDs your token can use

A 401 {"error":{"message":"Invalid token ...","type":"new_api_error"}} here means the token is wrong/expired — fix the token, the base URL is fine.

3. Make a call

scripts/wrouter.sh chat "claude-sonnet-5" "Say hello in one word."

Or with the OpenAI SDK — only two settings change:

from openai import OpenAI
client = OpenAI(base_url="https://wrouter.ai/v1", api_key="sk-…")
r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Say hello in one word."}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://wrouter.ai/v1", apiKey: "sk-…" });
const r = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Say hello in one word." }],
});

4. Integrations

• LangChain (ChatOpenAI): ChatOpenAI(model="…", api_key="sk-…", base_url="https://wrouter.ai/v1").
• n8n: install the community node n8n-nodes-wrouter, add the WRouter Chat Model node, and create a WRouter API credential with Base URL https://wrouter.ai/v1 + your sk-… token.
• Any OpenAI-compatible tool: set the base URL to https://wrouter.ai/v1 and the key to your token.

Troubleshooting