Installation

Roo Code + Luma Cloud

Roo Code can use OpenAI-compatible custom providers. Keep tool-call support marked verified only after a native tool stream smoke passes.

OpenAI Compatible ready

Recommended path

Choose OpenAI Compatible, paste endpoint and key, then use a canonical model id from /docs/models.

Run a short response and a tool-capable task before claiming full native tool support.

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: OpenAI Compatible
Base URL: https://api.lumaos.cloud/v1
API Key: $LUMA_CLOUD_API_KEY
Model: gpt-5.5-xhigh

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

Submit docs/preset PR after streaming and tool-call compatibility are confirmed.

Keep external provider submissions gated on the public v1 conformance smoke and request-id-first support docs.