OpenCRM
Customer FAQ · OpenRouter configuration
OpenCRM Customer FAQ
Oi · AI in OpenCRM

OpenRouter configuration guide

Choosing an integration method, creating your OpenRouter API key, and setting up BYOK or OpenRouter managed providers.

01Step 1: Create an OpenRouter account and API key
02Option 1: Bring Your Own Provider Key (BYOK)
03Option 2: Use OpenRouter managed providers
04Settings in OpenCRM
05Selecting the right approach
Before you start: choose your integration method

OpenCRM supports three AI integration methods. You must choose one integration method within OpenCRM.

OpenAI (direct integration)
If you only intend to use OpenAI models, this is usually the simplest option.
Gemini (direct integration)
If you only intend to use Gemini models, this is usually the simplest option.
OpenRouter
If you want to use Claude, multiple AI providers, or leverage Bring Your Own Key (BYOK) across several providers.

This guide covers the OpenRouter option.

01

Step 1: Create an OpenRouter account and API key

QHow do I create an OpenRouter account?

Before configuring any models, create an OpenRouter account and generate an API key.

  1. Register for an OpenRouter account.
  2. Verify your email address.
  3. Sign in to your OpenRouter account.

QHow do I create an API key?

  1. From the left-hand menu, select API Keys.
  2. Click + New Key.
  3. Complete the fields as required:
    • Owner: Select the appropriate owner.
    • Name: Enter a meaningful name, for example OpenCRM Integration.
    • Expiration: Select the desired expiry period.
    • Credit Limit: Optionally set a spending limit for the key.
  4. Click Create.
  5. Copy and securely store the generated API key.
Important: If the API key will be used for an organisation-wide integration, set the ownership option to Workspace rather than Me. This ensures the key is owned and managed by the workspace rather than an individual user account.

Once the API key has been created, choose one of the following configuration options.

02

Option 1: Bring Your Own Provider Key (BYOK)

QWhen should I use BYOK?

Use this option when you already have accounts with one or more AI providers and want usage billed directly to those providers. Examples include:

  • OpenAI (GPT models)
  • Google (Gemini models)
  • Anthropic (Claude models)
  • xAI (Grok models)
  • Mistral
  • Other supported providers

The full list of supported providers can be found in the OpenRouter Providers Directory: openrouter.ai/providers

Note: You must be signed in to your OpenRouter account to view provider-specific settings and capabilities. Not all providers support customer-supplied API keys.

QHow do I configure BYOK?

  1. Create an account with your chosen AI provider(s).
  2. Generate an API key from each provider you wish to use.
  3. In OpenRouter, navigate to Settings → Providers.
  4. Add your provider API key(s).
  5. Configure model routing to use your selected provider(s).
  6. Disable provider fallbacks if you want requests to use only your own provider accounts.
  7. Configure OpenCRM using the OpenRouter API key created earlier.
  8. Select your required model(s) and test the connection.

QExample: how do I use Claude via OpenRouter?

OpenCRM→OpenRouter→Anthropic (Claude)
  1. Create an Anthropic account.
  2. Generate an Anthropic API key.
  3. Add the Anthropic key to OpenRouter.
  4. Select the required Claude model.
  5. Optionally restrict routing to Anthropic only.

QWhat is the result?

  • Usage is billed directly by the model provider.
  • You maintain a direct relationship with the provider.
  • OpenRouter acts as a routing and compatibility layer.
  • Multiple providers can be accessed through a single OpenRouter endpoint while retaining direct control of billing and provider access.
03

Option 2: Use OpenRouter managed providers

QWhen should I use OpenRouter managed providers?

Use this option when you do not want to create or manage separate provider accounts.

QHow do I configure managed providers?

  1. Add credit to your OpenRouter account.
  2. Select the required model from the OpenRouter catalogue.
  3. Leave provider routing set to OpenRouter defaults or specify a preferred provider if required.
  4. Configure OpenCRM using the OpenRouter API key created earlier.
  5. Test the connection.

QWhat is the result?

  • No separate provider accounts are required.
  • No provider API keys are required.
  • Billing is handled entirely through OpenRouter.
  • This is typically the quickest and simplest way to get started.
04

Settings in OpenCRM

QWhat do I enter in the "API Model" field?

Enter the model you want to use with OpenRouter. The value you need is shown underneath the model name on the model information page in OpenRouter, for example:

anthropic/claude-sonnet-5.5

Alternatively, enter openrouter/auto to use OpenRouter's automatic routing. This will use the models you have limited it to in your OpenRouter configuration.

QIf I'm using BYOK, what do I enter in the "Allowed Providers" field?

Set this to only the providers you have keys set up with, separated by commas, for example:

anthropic,openai,google

Why this matters: the same model is often available through more than one provider. Limiting which models your API key can use does not limit which provider OpenRouter uses to reach them. Without this setting, OpenRouter may send your request through a provider outside your BYOK setup, for example using an OpenAI model via Amazon Bedrock instead of via OpenAI directly.

This applies whether or not you are using automatic routing.

Tip: To find the value to use for a provider, ask the OpenRouter chat: "What is the OpenRouter slug for provider X?"
05

Selecting the right approach

RequirementRecommended integration
OpenAI onlyOpenAI Direct Integration
Gemini onlyGemini Direct Integration
Claude onlyOpenRouter with Anthropic BYOK
Multiple providers with your own API keysOpenRouter with BYOK
Single OpenRouter-managed billing relationshipOpenRouter Managed Providers
Recommendation

If you want to use multiple AI providers with your own provider accounts and API keys, select OpenRouter within OpenCRM and add all of your BYOK credentials to OpenRouter.

For example, a single OpenRouter account could contain:

OpenAI API keyGemini API keyAnthropic API keyxAI API key

OpenCRM then connects to OpenRouter using a single OpenRouter API key while OpenRouter manages routing to the appropriate provider. This provides a single integration point within OpenCRM while maintaining direct ownership of your provider accounts, usage and billing.

This guide is general guidance. OpenRouter and provider menus, features and policies change over time, so please check current terms with your chosen provider. For help configuring Oi, contact the OpenCRM support team.

OpenCRM · Customer information October 2026


Need More Help?

If you have any questions, just start a Live Chat, "Click" on the Chat Icon in the lower right corner to talk with our support team.