External Models Setup

API Models Setup

I’m trying to connect Cursor 3.1 with OpenRouter. I’ve already set up the OpenAI settings with the OpenRouter API in Cursor:
Entered my API key
Set the Override OpenAI Base URL to: OpenRouter

How do I get Cursor to do this and make it work

I have the Free Plan

Hey, the config is set up correctly, but on the Free plan, BYOK (your own API key via Override OpenAI Base URL) doesn’t work for Agent and Composer/Edit. This is a by-design limitation, not a bug. The backend returns an error like: “Agent and Edit rely on custom models that require a paid subscription”.

To use OpenRouter with your own key in Agent/Edit, you need a paid subscription (Pro or higher). On the Free plan, custom models via OpenRouter aren’t available.

Related threads for context: