> ## 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>

## Before you start

1. Create a Modellix API key in the [console](https://modellix.ai/console/api-key).
2. Pick 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.

## 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`). See [Models & Pricing](/llm/overview#models-and-pricing). |

Cursor sends `Authorization: Bearer <key>`, which Modellix accepts. 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>

## Model ID tips

* Prefer `openai/...` or `google/...` for the OpenAI-compatible path (same as [OpenAI SDK](/llm/openai-sdk)).
* `anthropic/...` can work on Chat Completions for many clients; for Anthropic-native tools use [Messages](/llm/messages) instead (see [Claude Code](/llm/claude-code)).
* Browse available Model IDs and rates on [Models & Pricing](/llm/overview#models-and-pricing)—do not assume bare upstream names without the `provider/` prefix.

## 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.

## 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) — auth, protocols, errors
* [OpenAI SDK](/llm/openai-sdk) — same gateway settings for app code
* [Codex](/llm/codex) · [OpenCode](/llm/opencode) — other OpenAI-compatible clients