API Documentation

OpenAI-compatible endpoints. Drop-in replacement for most AI tools.

Base URL

https://lumirouter.com/v1

Authentication

All API requests require a Bearer token:

Authorization: Bearer YOUR_API_KEY

Bring Your Own Key (BYOK)

Recommended for production. Use your own DeepSeek, Groq, or other provider API keys. LumiRoute provides the OpenAI-compatible gateway and auto-routing — you keep direct billing and compliance with each provider.

• Do not resell raw inference access through a shared operator key
• Provider keys stay on your side (per-user BYOK storage coming in B-030)
• Internal policy: docs/byok-policy.md

Health Check

No auth. Returns provider configuration status (cloudflare, groq, deepseek).

curl https://lumirouter.com/health

Endpoints

Send a chat completion request. Fully OpenAI-compatible.

List all available models including auto-routing options.

Auto-Router Models

Model	Behavior
auto	Smart routing based on request content
auto-cheap	Always cheapest sufficient model
auto-code	Code-focused model (DeepSeek Coder)
auto-quality	Highest quality model available

Available Models

Model	Provider
deepseek-chat	DeepSeek
deepseek-coder	DeepSeek
deepseek-reasoner	DeepSeek
openai/gpt-oss-20b	Groq
openai/gpt-oss-120b	Groq

Example Request

curl https://lumirouter.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [
      {"role": "user", "content": "Write a Python function to reverse a string"}
    ]
  }'

Routing Info in Response

When using auto models, the response includes a lumiroute field:

{
  "model": "deepseek-coder",
  "choices": [...],
  "lumiroute": {
    "requested_model": "auto",
    "routed_model": "deepseek-coder",
    "provider": "deepseek",
    "route_reason": "code keywords detected"
  }
}

Tool Compatibility

Works with any tool that supports custom OpenAI-compatible endpoints:

• Cursor
• Continue
• Cline
• Aider
• OpenCode

Set base URL to https://lumirouter.com/v1 and use your LumiRoute API key.