> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Cursor to APIONE

> Configure a custom OpenAI base URL and verify your chat model.

Cursor's custom API settings apply to features that allow external models. Available settings and plan requirements vary by version. Confirm that your client supports custom addresses and model IDs.

## Configure Cursor

1. Open **Settings → Models**.
2. Enable a custom key under **OpenAI API Key** and enter your APIONE key.
3. Enable **Override OpenAI Base URL** and enter `https://api.apione.ai/v1`.
4. Use **Add Custom Model** to add and enable an APIONE model ID.
5. Select that model in the chat panel and start a new conversation.

![Cursor Models settings with the APIONE Base URL and a concealed key.](https://mintcdn.com/apione/RowHqDetrhht-bZO/images/integrations/screenshots/cursor-apione-api-settings-v2.png?fit=max\&auto=format\&n=RowHqDetrhht-bZO\&q=85\&s=5a921e0766e1e66f205233bfd8b56011)

Cursor Models settings with the APIONE Base URL and a concealed key.

## Verify actual requests

Test plain text before code explanations and tool calls. Confirm activity in APIONE. Passing the settings page's Verify check does not guarantee compatibility with every chat mode. A custom key does not redirect all features, including Tab completion, to APIONE.

## Diagnose errors

* A plan upgrade prompt is governed by Cursor's account policy.
* For a missing model, copy the ID again from the [APIONE model directory](https://apione.ai/en/models).
* For messages, input, or tool errors, check whether the request uses Chat Completions or Responses and whether the model supports it.
* For URL errors, check for a duplicated /v1.

Do not assume that fixes for another gateway apply here. Include the client version, model ID, request ID, and a redacted error when reporting a problem.

***

[Integration directory](https://apione.ai/docs/en/guides/clients.md) · [Choose a model](https://apione.ai/docs/en/models/catalog.md) · [Troubleshooting](https://apione.ai/docs/en/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.