Model Rover
GuidesAPI Reference

Cursor

Route Cursor BYOK requests through the OpenAI-compatible gateway.

Cursor can send BYOK requests through an OpenAI-compatible provider. See the Cursor documentation for the current client behavior.

Configure

Open Cursor Settings → Models → API Keys.

Enable OpenAI API Key and enter your platform key.

Enable Override OpenAI Base URL and enter http://127.0.0.1:11113/v1. Do not add /chat/completions; Cursor appends the operation path.

Add a model and paste the complete <FULL_MODEL_ID> copied from the Models page. Choose a model that supports function calling.

Save the settings and verify the model as described below.

Verify

In Cursor chat or Agent mode, select the newly added model. First request a text response, then run a read-only tool action such as listing the workspace files. Finally, open Request Logs and check the model, status, and request ID.

BYOK coverage varies

The BYOK override covers only requests Cursor sends through that OpenAI-compatible provider. Tab completion is not affected. Whether Auto, Composer, hosted models, and other managed features use BYOK depends on the current Cursor version and plan; some plans may disable custom models. Cursor changes quickly, so repeat the text and tool-call acceptance test after upgrades. Do not assume every Cursor feature uses the platform key.

Limitations

This integration covers Cursor's OpenAI Chat Completions-compatible request path. Features that require Cursor's own backend or another protocol are outside its scope. A successful text response does not prove that the Agent tool loop is compatible.

Troubleshooting

  • 401: Check the platform key.
  • 404: Check the base URL; it must include /v1 and must not include an operation path.
  • Model not found: Use the complete model ID from /models.
  • Text works but tools fail: Check that the model supports function calling and treat the result as a current Cursor compatibility issue; do not claim broad compatibility from a text-only success.

Help us improve this page

Found something unclear, outdated, or incorrect?

Last updated on

On this page

ConfigureVerifyLimitationsTroubleshooting