Documentation

Setup Guide

Get Omega Plus running inside your IDE or AI client with the real proxy URL, Omega model IDs, and Anthropic-compatible endpoints.

Drop-in Compatible Per-Key Budgets Proxy Auth 23 Models

Prerequisites

Node.js 18 or newer

Required for running the Omega Plus npm setup wizard with npx.

Omega Plus API key

Create or receive a customer API key before connecting a coding tool.

Supported coding tool

Claude Code, Codex, OpenCode, Cline, Roo Code, Kilo Code, Factory Droid, OpenClaw, Zed, Warp, Continue, Aider, Cursor, Windsurf, or any OpenAI/Anthropic-compatible client.

If Node.js is not installed, download the official installer from nodejs.org, then reopen your terminal and run the setup command.

Quick Setup

Run the Omega Plus setup wizard, paste your API key, then choose the coding tool you want to configure.

Main Command
npx -y @kesarcloud/omega-plus-cli@latest
Connection Values
API origin: https://api.omegaplusapi.com
Anthropic-compatible URL: https://api.omegaplusapi.com
OpenAI-compatible URL: https://api.omegaplusapi.com/api/v1
API Key: YOUR_API_KEY
Primary model: omega-plus
Fast model: omega-plus

Interactive Setup Flow

The wizard keeps the API key out of the shell history, detects installed tools, and writes the right config for the selected tool.

01

Omega Plus banner appears in the terminal.

02

User pastes the Omega API key when prompted.

03

Wizard validates the key and lists available coding tools.

04

User enters the tool number, then Omega Plus writes the config.

05

User opens or restarts the selected coding tool.

Connect your workspace

Coding-agent setup

23 public models. Complete files, OS-specific instructions and honest compatibility notes. Helper 2.9.1 · catalog verified 2026-09-12.

Loading complete tutorial…

Authentication

Proxy endpoints accept API key authentication through either header. Dashboard endpoints use JWT tokens returned from the login endpoint.

Header Options
x-api-key: YOUR_API_KEY
# OR
Authorization: Bearer YOUR_API_KEY
POST/v1/messagesAPI Key

Messages

Create a message with Anthropic-compatible request and response shape. Set stream: true for SSE streaming.

Request
{
  "model": "omega-plus",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Hello, Omega!" }
  ],
  "stream": false
}

Image & Vision

All 23 public models advertise image input. Send images via /v1/messages (Anthropic format) or /api/v1/chat/completions (OpenAI format).

Anthropic Format (POST /v1/messages)

Request
{
  "model": "claude-fable-5",
  "max_tokens": 256,
  "messages": [{
    "role": "user",
    "content": [
      {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/png",
          "data": "<base64-encoded-image>"
        }
      },
      {
        "type": "text",
        "text": "What do you see in this image?"
      }
    ]
  }]
}

OpenAI Format (POST /api/v1/chat/completions)

Request
{
  "model": "claude-fable-5",
  "max_tokens": 256,
  "messages": [{
    "role": "user",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "data:image/png;base64,<base64-encoded-image>"
        }
      },
      {
        "type": "text",
        "text": "What do you see in this image?"
      }
    ]
  }]
}

Vision Capability

ModelVisionMethod
Omega PlusYesNative
Claude Opus 4.6 / 4.7 / 4.8YesNative
Claude Sonnet 4.6YesNative
Fable 5YesNative
GPT 5.5YesNative
Gemini 3.1 ProYesNative
MiniMax M3YesNative (multimodal)
DeepSeek V4 ProBridgeOmega Vision Bridge
Qwen 3.7 PlusBridgeOmega Vision Bridge
GLM 5.2BridgeOmega Vision Bridge

Omega Vision Bridge — DeepSeek V4 Pro, Qwen 3.7 Plus, and GLM 5.2 don't natively support vision. Omega Vision Bridge automatically describes images to text, then sends the text description to the model. Fully transparent — no configuration needed, images work out of the box.

GET/v1/modelsNone

Models

List all available public Omega model IDs.

Response
{
  "data": [
    {
      "id": "omega-plus",
      "object": "model",
      "display_name": "Omega Plus"
    },
    {
      "id": "claude-opus-4-6",
      "object": "model",
      "display_name": "Claude Opus 4.6"
    },
    {
      "id": "claude-opus-4-7",
      "object": "model",
      "display_name": "Claude Opus 4.7"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "display_name": "Claude Opus 4.8"
    },
    {
      "id": "gpt-5.5",
      "object": "model",
      "display_name": "GPT 5.5"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "display_name": "Claude Sonnet 4.6"
    },
    {
      "id": "gemini-3.1-pro",
      "object": "model",
      "display_name": "Gemini 3.1 Pro"
    },
    {
      "id": "deepseek-v4-pro",
      "object": "model",
      "display_name": "DeepSeek V4 Pro"
    },
    {
      "id": "qwen-3.7-plus",
      "object": "model",
      "display_name": "Qwen 3.7 Plus"
    },
    {
      "id": "minimax-m3",
      "object": "model",
      "display_name": "MiniMax M3"
    },
    {
      "id": "glm-5.2",
      "object": "model",
      "display_name": "GLM 5.2"
    },
    {
      "id": "claude-fable-5",
      "object": "model",
      "display_name": "Fable 5"
    },
    {
      "id": "claude-sonnet-5",
      "object": "model",
      "display_name": "Claude Sonnet 5"
    },
    {
      "id": "gpt-5.6-sol",
      "object": "model",
      "display_name": "GPT-5.6 Sol"
    },
    {
      "id": "claude-opus-5",
      "object": "model",
      "display_name": "Claude Opus 5"
    },
    {
      "id": "quantum-lite-1",
      "object": "model",
      "display_name": "Quantum Lite 1"
    },
    {
      "id": "gemini-3.6-flash",
      "object": "model",
      "display_name": "Gemini 3.6 Flash"
    },
    {
      "id": "gemini-3.7-flash",
      "object": "model",
      "display_name": "Gemini 3.7 Flash"
    },
    {
      "id": "gemini-3.8-flash",
      "object": "model",
      "display_name": "Gemini 3.8 Flash"
    },
    {
      "id": "glm-5.3-flash",
      "object": "model",
      "display_name": "GLM 5.3 Flash"
    },
    {
      "id": "deepseek-v4-flash",
      "object": "model",
      "display_name": "DeepSeek V4 Flash"
    },
    {
      "id": "qwen-3.8",
      "object": "model",
      "display_name": "Qwen 3.8"
    },
    {
      "id": "quantum-flash",
      "object": "model",
      "display_name": "Quantum Flash (temporarily free; eligibility required)"
    }
  ]
}
POST/v1/messages/count_tokensAPI Key

Token Counting

Count tokens for a message without sending it to a provider.

Request
{
  "model": "omega-plus",
  "messages": [
    { "role": "user", "content": "How many tokens is this?" }
  ]
}
POST/api/auth/loginEmail + Password

Dashboard Auth

Use this route to sign in to dashboard sessions.

Request
{
  "email": "YOUR_EMAIL",
  "password": "YOUR_PASSWORD"
}

Available Models

Omega Plus

omega-plus

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Opus 4.6

claude-opus-4-6

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Opus 4.7

claude-opus-4-7

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Opus 4.8

claude-opus-4-8

1,000,000 total context · 128,000 maximum output (route-dependent).

GPT 5.5

gpt-5.5

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Sonnet 4.6

claude-sonnet-4-6

1,000,000 total context · 128,000 maximum output (route-dependent).

Gemini 3.1 Pro

gemini-3.1-pro

1,000,000 total context · 128,000 maximum output (route-dependent).

DeepSeek V4 Pro

deepseek-v4-pro

1,000,000 total context · 128,000 maximum output (route-dependent).

Qwen 3.7 Plus

qwen-3.7-plus

1,000,000 total context · 128,000 maximum output (route-dependent).

MiniMax M3

minimax-m3

1,000,000 total context · 128,000 maximum output (route-dependent).

GLM 5.2

glm-5.2

1,000,000 total context · 128,000 maximum output (route-dependent).

Fable 5

claude-fable-5

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Sonnet 5

claude-sonnet-5

1,000,000 total context · 128,000 maximum output (route-dependent).

GPT-5.6 Sol

gpt-5.6-sol

1,000,000 total context · 128,000 maximum output (route-dependent).

Claude Opus 5

claude-opus-5

1,000,000 total context · 128,000 maximum output (route-dependent).

Quantum Lite 1

quantum-lite-1

1,000,000 total context · 128,000 maximum output (route-dependent).

Gemini 3.6 Flash

gemini-3.6-flash

1,000,000 total context · 65,536 maximum output (route-dependent).

Gemini 3.7 Flash

gemini-3.7-flash

1,000,000 total context · 65,536 maximum output (route-dependent).

Gemini 3.8 Flash

gemini-3.8-flash

1,000,000 total context · 65,536 maximum output (route-dependent).

GLM 5.3 Flash

glm-5.3-flash

1,000,000 total context · 65,536 maximum output (route-dependent).

DeepSeek V4 Flash

deepseek-v4-flash

1,000,000 total context · 65,536 maximum output (route-dependent).

Qwen 3.8

qwen-3.8

1,000,000 total context · 65,536 maximum output (route-dependent).

Quantum Flash (temporarily free; eligibility required)

quantum-flash

262,000 total context · 65,000 maximum output (route-dependent).

Build Notes

Built-in search and vision

Omega Plus exposes standard OpenAI, Anthropic, and Responses-compatible endpoints without requiring a gateway-specific tool loop.

Vision capability

All 23 public identities advertise image input through the gateway. Client attachment support depends on the selected adapter. Public identity names do not guarantee a particular upstream model.

Troubleshooting

Connection errors

Confirm the API server is running at https://api.omegaplusapi.com.

Model not found

Use exact model IDs from the Available Models section.

Rate limited

Your five-hour token window or RPM cap may be exhausted.

Changes not applying

Restart your IDE after any config change.

Editor integration

See the compatibility notes in Coding-agent setup; native custom endpoint support is not assumed.