Cursor + Luma Cloud

Before you start

• Create a Luma Cloud API key in Dashboard → API and copy a model ID from the authenticated model catalog.
• Your Cursor version must expose Override OpenAI Base URL and accept the chosen model. Save your existing endpoint settings before changing them.

Get an API key and a model ID →

Set up Cursor

1. Check the override

   Open Cursor Settings → Models → API Keys. Find OpenAI API Key and Override OpenAI Base URL. This override can affect other models; use a dedicated setup if you need to preserve them.

2. Set the URL and credential together

   In that same Models panel, paste the Luma Cloud API key into OpenAI API Key and set the enabled Base URL override to https://api.lumaos.cloud/v1. Use the API Key field on macOS, Windows, or Linux. Do not put credentials in .cursor/rules or workspace settings.

3. Add and select a compatible model

   If your version offers Add model, enter the exact catalog ID and enable it. Click Save for the API settings. Start a fresh chat and explicitly select that model; an automatic or built-in model selection is not evidence that Luma Cloud is being used.

4. Test one chat request

   Send the example below. If Cursor rejects the model, the conditional connection is not usable with that model/version. Do not rename a model to impersonate a supported one. Continue or Cline inside a supported editor can be configured independently using their own guide.

5. Return to your earlier setup when needed

   Restore the original Base URL override state and provider credential in Models, save, and start a new conversation. Avoid leaving a Luma key paired with the official OpenAI URL, or an OpenAI key paired with the Luma Cloud URL.

Base URL

https://api.lumaos.cloud/v1

API key

Your Luma Cloud key, entered in the client's secret field

Model ID

MODEL_ID_FROM_CATALOG

Reply with exactly: Luma Cloud connection works.

Check the connection

1. Send a short text request, then check Usage → API Wallet for Wallet usage, or subscription Usage for Builder keys. A populated model list alone does not confirm a successful response.
2. Check that any existing provider you keep using still works after changing the global override.

For errors or a request that stops, see troubleshooting. A visible model list alone does not confirm that a chat or editing task can complete.

What to expect

• Cursor documents BYOK for chat and limits its OpenAI support to standard non-reasoning chat models. Reasoning and agent workflows are not guaranteed.
• Tab completion still uses Cursor's own models.
• Cursor sends BYOK requests through its backend for prompt preparation. This is not a direct-only connection from your computer.

Troubleshooting Cursor