Integration Docs

Connect your IDE or agent to Lightning Zeus.

Use one OpenAI-compatible endpoint for multi-model inference, model checks, coding agents, and custom tooling.

Canonical Base URL

https://lightningzeus.com/v1

Replace YOUR_API_KEY with an active key from your API Keys page.

Check available models

The model list is authenticated. Run this with your active API key.

bash

curl "https://lightningzeus.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Use one of the returned model IDs in chat completions, Claude-compatible tooling, or an IDE custom provider.

Basic chat request

Use the OpenAI Chat Completions shape with the Lightning Zeus base URL.

bash

curl "https://lightningzeus.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "Plan a cost-efficient model routing strategy."}
    ]
  }'

OpenAI Python SDK

Point the client at Lightning Zeus and keep your existing OpenAI-compatible code.

python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://lightningzeus.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "Summarize the value of multi-model inference."}],
)

print(response.choices[0].message.content)

Claude Code

Use the Anthropic-compatible environment variables when your workflow expects Claude-style APIs.

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://lightningzeus.com/",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
  }
}

Place this in your Claude Code settings file and choose model IDs that exist in your authenticated model list.

Codex / OpenAI-compatible tools

For tools that support a custom OpenAI base URL, use the Lightning Zeus endpoint and your API key.

env

OPENAI_API_KEY=YOUR_API_KEY
OPENAI_BASE_URL=https://lightningzeus.com/v1
OPENAI_MODEL=gpt-5.5

If a Codex surface only supports ChatGPT subscription OAuth and not custom API endpoints, use this gateway through SDK, CLI, or IDE tools that expose a custom provider setting.

OpenClaw

Configure Lightning Zeus as an OpenAI-compatible custom provider.

yaml

providers:
  lightningzeus:
    type: openai-compatible
    baseUrl: "https://lightningzeus.com/v1"
    apiKey: "YOUR_API_KEY"

agents:
  defaults:
    models:
      - provider: lightningzeus
        model: gpt-5.5
      - provider: lightningzeus
        model: claude-opus-4.8
      - provider: lightningzeus
        model: claude-sonnet-4.6

Run the model check first, then replace model IDs with the exact IDs returned for your account.

Hermes IDE

Use a custom OpenAI-compatible provider for each Hermes session that should route through Lightning Zeus.

json

{
  "providers": {
    "lightningzeus": {
      "kind": "openai-compatible",
      "baseUrl": "https://lightningzeus.com/v1",
      "apiKey": "YOUR_API_KEY",
      "models": ["gpt-5.5", "claude-opus-4.8", "claude-sonnet-4.6"]
    }
  },
  "defaultProvider": "lightningzeus",
  "defaultModel": "gpt-5.5"
}

Use separate Hermes sessions for different models when you want review, implementation, and verification to run independently.

One base URL

Point tools at https://lightningzeus.com/v1.

One API key

Use an active key from your customer dashboard.

Many model families

Check `/models` and choose the right model per workflow.