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

# Use Modellix LLM with Cursor

> Add Modellix as an OpenAI-compatible provider in Cursor using https://llm.modellix.ai/v1, your Modellix API key, and provider/name model IDs.

Use Modellix models inside [Cursor](https://cursor.com) by adding an OpenAI-compatible provider that targets the LLM gateway. Cursor talks Chat Completions-style APIs; Modellix exposes them at [`POST /v1/chat/completions`](/llm/chat-completions).

<Note>
  Modellix media generation (image / video / speech) uses a different host and async task API. This page covers **LLM text** only (`https://llm.modellix.ai`).
</Note>

## Set Up Cursor

<Steps>
  <Step title="Get a Modellix API Key">
    Create a Modellix API key in the [console](https://modellix.ai/console/api-key). Cursor sends `Authorization: Bearer <key>`, which Modellix accepts.
  </Step>

  <Step title="Pick a Model ID">
    Choose a model ID in `provider/name` form (for example `openai/gpt-5.5`). See [Models & Pricing](/llm/overview#models-and-pricing) for the full list.

    * Prefer `openai/...` or `google/...` for the OpenAI-compatible path (same as [OpenAI SDK](/llm/sdk/openai-sdk)).
    * `anthropic/...` can work on Chat Completions for many clients; for Anthropic-native tools use [Messages](/llm/messages) instead (see [Claude Code](/llm/agent/claude-code)).
    * Do not assume bare upstream names without the `provider/` prefix.
  </Step>

  <Step title="Add an OpenAI-Compatible Provider">
    In Cursor settings, open the models / providers section and add a custom **OpenAI-compatible** (or equivalent override) endpoint:

    | Field    | Value                                                   |
    | -------- | ------------------------------------------------------- |
    | Base URL | `https://llm.modellix.ai/v1`                            |
    | API key  | Your Modellix API Key                                   |
    | Model    | Exact `provider/name` ID (for example `openai/gpt-5.5`) |

    Include `/v1` in the base URL so paths resolve to `/v1/chat/completions`.

    <Tip>
      If Cursor asks for a full chat completions URL instead of a base URL, use `https://llm.modellix.ai/v1/chat/completions`. Prefer base URL + model ID when the UI supports it.
    </Tip>
  </Step>

  <Step title="Optional: Anthropic-Style Override">
    If your Cursor build allows a separate Anthropic base URL override, use:

    | Field    | Value                                |
    | -------- | ------------------------------------ |
    | Base URL | `https://llm.modellix.ai` (no `/v1`) |
    | API key  | Same Modellix API Key                |
    | Model    | `anthropic/...`                      |

    Otherwise keep the OpenAI-compatible setup above for Chat Completions.
  </Step>
</Steps>

## Troubleshooting

| Symptom                 | Check                                                                   |
| ----------------------- | ----------------------------------------------------------------------- |
| 401                     | Key is a Modellix key; Bearer header is present                         |
| 404 on model            | Model ID includes `provider/` and is currently available                |
| Wrong path / 404 on URL | Base URL should be `https://llm.modellix.ai/v1`, not the media API host |
| Empty or odd responses  | Confirm the selected model supports the request shape Cursor sends      |

## Related

* [LLM API guide](/llm/api/api) — auth, protocols, errors
* [OpenAI SDK](/llm/sdk/openai-sdk) — same gateway settings for app code
* [Codex](/llm/agent/codex) · [OpenCode](/llm/agent/opencode) — other OpenAI-compatible clients