Installation
Cursor + Luma Cloud
Cursor connects through its custom/OpenAI-compatible API path when the current build exposes base URL and model fields. There is no native Luma Cloud listing in Cursor yet, so manual provider fields are the supported route.
Recommended path
Open Cursor model/provider settings, choose the custom OpenAI-compatible path, paste the Luma Cloud /v1 endpoint and API key, then enter the canonical model id.
Run a small editor-agent task with gpt-5.5-medium first. Switch default work to gpt-5.5-xhigh only after streaming and tool behavior are acceptable.
Use only the /v1 endpoint from your dashboard. Never paste localhost or other internal URLs into client settings.
Copy-safe config
Use this as the exact client-facing fallback when no native provider listing exists yet.
Provider: Custom OpenAI / OpenAI Compatible
Base URL: https://api.lumaos.cloud/v1
API Key: $LUMA_CLOUD_API_KEY
Model: gpt-5.5-xhighProvider fields
Use the same values across clients.
These values come from the shared Luma Cloud provider registry and must match /v1/models and provider-catalog submissions.
Provider ID
luma-cloud
Display name
Luma Cloud
Provider type
OpenAI-compatible
Base URL
https://api.lumaos.cloud/v1
API key env
LUMA_CLOUD_API_KEY
Default model
gpt-5.5-xhigh
Fast smoke model
gpt-5.5-medium
Distribution
Native listing path.
Cursor stays a manual setup guide until a provider marketplace or extension submission path is confirmed; there is no native Cursor listing yet.