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

# Cursor

> Configure AIHubMix's OpenAI-compatible endpoint in Cursor, then use AIHubMix models for coding chat, completion, and agent workflows.

Cursor is an AI code editor. This guide shows how to configure AIHubMix in Cursor so Cursor can call AIHubMix models through an OpenAI-compatible endpoint.

Download: [Cursor official download](https://cursor.com/downloads)

## Prerequisites

* Install and open Cursor.
* Create an API Key in the [AIHubMix Console](https://aihubmix.com/token).
* Prepare the model ID you want to use. Copy it from the [AIHubMix model list](https://aihubmix.com/models) to avoid typing mistakes.

## Configure AIHubMix

### 1. Open Models settings

Click the settings button in the upper-right corner of Cursor, then open **Models**.

<img src="https://mintcdn.com/aihubmix/a82Z9lzt0I0bu74l/public/cn/Cursor-new-01.png?fit=max&auto=format&n=a82Z9lzt0I0bu74l&q=85&s=d953e1a052f140f49bb06f8503ff6057" alt="Open Cursor Models settings" width="1920" height="1030" data-path="public/cn/Cursor-new-01.png" />

### 2. Enter the API Key and Base URL

Enter the API Key created in the AIHubMix Console under **OpenAI API Key**.

Turn on **Override OpenAI Base URL**, then enter:

```text theme={null}
https://aihubmix.com/v1
```

If the primary endpoint is temporarily unavailable, use the backup endpoint:

```text theme={null}
https://api.inferera.com/v1
```

<img src="https://mintcdn.com/aihubmix/a82Z9lzt0I0bu74l/public/cn/Cursor-new-02.png?fit=max&auto=format&n=a82Z9lzt0I0bu74l&q=85&s=b201f44cd647b3e9b9905543f37f2769" alt="Enter OpenAI API Key and Base URL" width="1920" height="1030" data-path="public/cn/Cursor-new-02.png" />

After filling in the fields, click **Verify**. When verification succeeds, Cursor can send OpenAI-compatible requests through AIHubMix.

### 3. Add a model

Add the model ID you want to use in the model settings area, for example `gpt-5.6-terra`. The model ID must match the name in the AIHubMix model list.

<img src="https://mintcdn.com/aihubmix/a82Z9lzt0I0bu74l/public/cn/Cursor-new-03.png?fit=max&auto=format&n=a82Z9lzt0I0bu74l&q=85&s=c66553998cc419b75d8449bac4c554fe" alt="Add an AIHubMix model" width="1920" height="1030" data-path="public/cn/Cursor-new-03.png" />

To use Claude, Gemini, Qwen, Kimi, or other models, add the model ID supported by AIHubMix directly. Avoid selecting Cursor's built-in official model entries, because those entries may use the provider's own default endpoint instead of the AIHubMix address configured above.

## Use and verify

Return to Cursor, select the model you added in the chat or Agent panel, and send a simple request. If Cursor returns a normal response, the configuration is working.

<img src="https://mintcdn.com/aihubmix/a82Z9lzt0I0bu74l/public/cn/Cursor-new-04.png?fit=max&auto=format&n=a82Z9lzt0I0bu74l&q=85&s=96623bc2b341085fc88874f9efe6adfd" alt="Use an AIHubMix model in Cursor" width="1920" height="1030" data-path="public/cn/Cursor-new-04.png" />

## FAQ

**What should I do if Verify fails?**

Check that the API Key is complete, the Base URL includes `/v1`, and your network can access the configured address. If the primary endpoint is temporarily unavailable, change **Override OpenAI Base URL** to `https://api.inferera.com/v1` and verify again.

**Why is Cursor not using AIHubMix after I select a model?**

Make sure you selected the AIHubMix model ID you added to the model list, not Cursor's built-in official model entry. With this setup, Cursor sends OpenAI-compatible requests to the Base URL you configured.

***

Last updated: 2026-08-04
