Integrations · OpenRouter
Guild agents call models from every publisher Guild supports through one OpenRouter API key. Guild holds the key server-side, checks your model policies on every call, and OpenRouter bills the calls to your account.
Book a demo
See how teams govern agents that use OpenRouter.
Start free
Connect OpenRouter and scope your first agent.
One key, eight publishers
OpenRouter routes to Anthropic, OpenAI, Gemini, Meta, DeepSeek, Alibaba, Moonshot AI, and Z.ai. Guild refreshes its list from OpenRouter’s public catalog every day. You write canonical names such asclaude-sonnet-4-6, and Guild adds the namespace and OpenRouter’s spelling, such as anthropic/claude-sonnet-4.6.
How it works
1
Create an OpenRouter key
In your OpenRouter account, create an API key.
2
Add the credential
In Access & setup > Models & providers, click Add API key and choose OpenRouter. Paste the key and check every publisher this credential should reach under Models.
3
Scope it with policies
Add model policies that decide which workspaces and agents may call which models, then call them from
task.llm by canonical name.Every OpenRouter call goes through your policies
Agents never hold the key. Guild stores the credential server-side and shows only a masked value, so you can rotate it without touching agent code or the model policies bound to it. Policies are an allowlist: a workspace, agent, or installed agent can call a model through it only if a rule allows it. Set a daily token limit to cap spend, and see each call by workspace, agent, and user in Usage. A raw API key in an agent’s environment reaches every model the key can. A policy reaches only the models you name.About OpenRouter on Guild
Publishers on OpenRouter
Guild refreshes its list from OpenRouter’s public model catalog every day, keeping the text models in these namespaces. Variants with a suffix after a colon, such as
:free, aren’t listed. To see what’s available, browse OpenRouter’s models and drop the namespace: qwen/qwen3-coder becomes qwen3-coder.
Connect OpenRouter
1
Create a key
In your OpenRouter account, create an API key.
2
Start the credential
In Guild, click Access & setup in the left nav, then Models & providers. Click Add API key and choose OpenRouter from the menu.
3
Name it and paste the key
Give the credential a Name, such as
Production, and paste the key into API key.4
Choose publishers
Under Models, check each publisher this credential should reach. Keep or change the default model next to each one.
5
Save
Click Add Key.
Model IDs
Write canonical model names, such asclaude-sonnet-4-6 or deepseek-r1, in policies and llmPreferences, without the OpenRouter namespace. Guild adds the namespace for you. OpenRouter spells Claude versions with dots, so Guild maps claude-sonnet-4-6 to anthropic/claude-sonnet-4.6.
Pricing
OpenRouter bills your OpenRouter account at its own rates, and those rates change as OpenRouter and the model publishers update them. For current prices, check each model’s page on OpenRouter’s models list, and see OpenRouter pricing for how OpenRouter charges. Guild’s Usage pages estimate spend from Guild’s own price list, which can lag behind OpenRouter’s. For a model Guild hasn’t priced yet, the estimate uses a fallback rate. Your OpenRouter account is the source of truth for what you paid.Frequently asked questions
Can one OpenRouter key cover every publisher?
Can one OpenRouter key cover every publisher?
Yes. Check every publisher under Models when you add the credential, and one key reaches all of them.
Do Guild's usage numbers match my OpenRouter bill?
Do Guild's usage numbers match my OpenRouter bill?
Not exactly. Guild estimates spend from its own price list, which can lag behind OpenRouter’s rates, and uses a fallback rate for models it hasn’t priced. Your OpenRouter account is the source of truth for what you paid.
Can I use free variants such as :free?
Can I use free variants such as :free?
No. Variants with a suffix after a colon aren’t listed.
Do I include the OpenRouter namespace in model names?
Do I include the OpenRouter namespace in model names?
No. Write canonical names, such as
deepseek-r1, in policies and llmPreferences. Guild adds the namespace for you.Put a governed agent on OpenRouter this week
Book a demo
See how teams govern agents that use OpenRouter.
Start free
Connect OpenRouter and scope your first agent.