OpusZen Docs
Anthropic-compatible API gateway providing Claude API access without waitlists. Drop-in replacement for any client — set your Base URL to https://api.opuszen.shop.
Overview
OpusZen is an ultra-low latency, Anthropic-compatible API gateway providing Claude API access without waitlists or regional limits. It works with Claude Code, Cursor, Windsurf, Cline, Roo Code, and official Anthropic SDKs — simply set your Base URL to https://api.opuszen.shop and use your API key.
Pass-through streaming with first-chunk delivery in milliseconds.
Built-in upstream redundancy guarantees 99.9% request uptime.
Granular rolling 5-hour windows and per-key usage protection.
Built-in real-time web search and multimodal image understanding.
Anthropic prompt cache read tokens are free and pass through directly.
Full OPTIONS preflight support for local tools, Electron, and web apps.
Quick Start
Prerequisites
- Node.js 18+ (for NPX CLI installer or Node SDK)
- OpusZen API key (starts with
sk_live_...or reseller key) - Target tool: Claude Code, Cursor, Windsurf, VS Code, Cline, Python, or TypeScript
1. Interactive Setup (Recommended)
Run the official interactive CLI wizard — it configures your editor, tests connectivity, and sets models:
npx opuszen2. One-Line Platform Installers
Fast automated setup for macOS, Linux, or Windows terminals:
irm https://api.opuszen.shop/setup.ps1 | iexcurl -fsSL https://api.opuszen.shop/setup.sh | bash3. Manual Environment Configuration
Export these environment variables in your terminal or ~/.bashrc / ~/.zshrc:
export ANTHROPIC_BASE_URL="https://api.opuszen.shop"
export ANTHROPIC_API_KEY="YOUR_API_KEY"IDE Configuration
Add or edit your settings file located at ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://api.opuszen.shop",
"ANTHROPIC_MODEL": "Opus 4.8",
"ANTHROPIC_SMALL_FAST_MODEL": "Haiku 4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "Sonnet 4.6",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "Opus 4.8",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Haiku 4.5",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"hasCompletedOnboarding": true
}In Cursor Settings (Ctrl+, or Cmd+,) under Models, configure:
https://api.opuszen.shop/v1YOUR_API_KEYclaude-opus-4-8, claude-sonnet-4-6Note: Cursor requires the trailing /v1 path.
In Windsurf settings, configure the Anthropic / OpenAI compatible endpoint:
https://api.opuszen.shop/v1Select API Provider Anthropic and set your base URL and key:
https://api.opuszen.shop/v1YOUR_API_KEYOr add to VS Code settings.json:
{
"cline.apiProvider": "anthropic",
"cline.anthropicBaseUrl": "https://api.opuszen.shop/v1",
"cline.apiKey": "YOUR_API_KEY",
"cline.anthropicModelId": "claude-opus-4-8"
}SDKs & Code Examples
OpusZen is a drop-in replacement for the official Anthropic API. Switch tabs to see code examples in Python, TypeScript, raw cURL, SSE streaming, and the OpenAI SDK.
pip install anthropicimport anthropic
# Initialize the client pointing to OpusZen
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://api.opuszen.shop",
)
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
messages=[
{"role": "user", "content": "Explain quantum computing in one paragraph."}
],
)
print(message.content[0].text)API Reference
https://api.opuszen.shopEndpoints support both /v1/ and /api/v1/
Authentication Headers
Authenticate by sending your API key in either header:
x-api-key: YOUR_API_KEYAuthorization: Bearer YOUR_API_KEYGateway Endpoints
/v1/messageshttps://api.opuszen.shop/v1/messagesCreate a message completion. Supports text generation, multi-turn chat, system prompts, streaming, and vision.
{
"model": "claude-opus-4-8",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Hello, Claude!" }
],
"stream": false
}{
"id": "msg_01XyZ890OpusZenLive",
"type": "message",
"role": "assistant",
"model": "claude-opus-4-8",
"content": [
{
"type": "text",
"text": "Hello! How can I assist you with your projects today?"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 12,
"output_tokens": 14
}
}/v1/modelshttps://api.opuszen.shop/v1/modelsList all currently available models, context window specifications, and release dates.
{
"data": [
{
"id": "claude-opus-4-8",
"display_name": "Claude Opus 4.8",
"context_window": 1000000,
"type": "model"
},
{
"id": "claude-sonnet-4-6",
"display_name": "Claude Sonnet 4.6",
"context_window": 1000000,
"type": "model"
}
]
}/v1/messages/count_tokenshttps://api.opuszen.shop/v1/messages/count_tokensEstimate token count for a message or prompt without invoking model generation.
{
"model": "claude-opus-4-8",
"messages": [
{ "role": "user", "content": "How many tokens is this sentence?" }
]
}/api/key-statushttps://api.opuszen.shop/api/key-status?key=YOUR_API_KEYInspect the status of your API key, plan details, remaining balance, and rate limit reset timer.
{
"valid": true,
"status": "active",
"plan": "Pro Developer",
"name": "Production Opus Key",
"balance": 250.00,
"usage": {
"tokens_used": 154200,
"limit": 5000000,
"reset_in_seconds": 1800
}
}Error Codes & Status
Standard HTTP response status codes returned by the gateway:
| Status | Error Name | Meaning & Resolution |
|---|---|---|
| 200 OK | Success | Request completed successfully or SSE streaming initiated. |
| 400 Bad Request | invalid_request | Malformed JSON or unsupported parameters. Check messages structure. |
| 401 Unauthorized | authentication_error | Invalid or missing API key. Verify key in /key-status. |
| 429 Rate Limit | rate_limit_error | 5-hour rolling token or request quota reached. Check reset time on Check Usage page. |
| 502 / 503 Gateway | api_error | Upstream provider error. OpusZen automatically triggers failover to fallback providers. |
Available Models
All models are Anthropic-compatible and work with standard Anthropic or OpenAI SDK calls. Click any Model ID to copy it to your clipboard.
| Model | Model ID | Context | Type | Release |
|---|---|---|---|---|
Claude Fable 5.1 | 1,000,000 tokens | Chat / Completion | Sep 2026 | |
Claude Fable 5 | 1,000,000 tokens | Chat / Completion | Jun 2026 | |
Claude Opus 5 | 1,000,000 tokens | Chat / Completion | Jul 2026 | |
Claude Sonnet 5 | 1,000,000 tokens | Chat / Completion | Jun 2026 | |
Claude Opus 4.8 | 1,000,000 tokens | Chat / Completion | May 2026 | |
Claude Opus 4.7 | 1,000,000 tokens | Chat / Completion | Apr 2026 | |
Claude Sonnet 4.6 | 1,000,000 tokens | Chat / Completion | Feb 2026 | |
Claude Opus 4.6 | 1,000,000 tokens | Chat / Completion | Feb 2026 | |
Claude Opus 4.5 | 200,000 tokens | Chat / Completion | Nov 2025 | |
Claude Sonnet 4.5 | 200,000 tokens | Chat / Completion | Sep 2025 | |
Claude Haiku 4.5 | 200,000 tokens | Chat / Completion | Oct 2025 |
Built-in Tools
Web search and image analysis are available directly on the server — no client-side MCP configuration or extra API keys required.
Web Search Tool
Real-time web search powered by OpusZen. Ideal for retrieval-augmented workflows.
POST https://api.opuszen.shop/tools/web_search{ "query": "latest Anthropic Claude 4.8 release notes" }Multimodal Image Analysis
Inspect image files via HTTP URL or base64-encoded payload (supports JPEG, PNG, WebP up to 18MB).
POST https://api.opuszen.shop/tools/understand_image{ "image": "https://example.com/screenshot.png", "prompt": "Describe this UI screenshot" }Troubleshooting & FAQ
Connection or CORS errors in Cursor / Windsurf
Make sure the Base URL ends in /v1 (e.g. https://api.opuszen.shop/v1). Restart your editor after saving the configuration.
401 Unauthorized / Invalid API Key
Verify your key at https://api.opuszen.shop/api/key-status?key=YOUR_KEY or on the Check Usage page. Ensure there are no leading or trailing whitespace characters.
Rate Limit Exceeded (HTTP 429)
Your 5-hour rolling token window has reached capacity. Check reset_in_seconds in /api/key-status or upgrade to a higher tier plan.
Model Not Found
Use an exact ID from the Available Models list above (e.g. claude-opus-4-8 or claude-sonnet-4-6).
Web search or multimodal tools not responding
Server-side tools are enabled by default for all authenticated keys. Verify your API key has an active plan with tools enabled.
Local development with Claude Code
Confirm ANTHROPIC_BASE_URL is set in ~/.claude/settings.json pointing to https://api.opuszen.shop. Run 'claude doctor' to verify connection.
Need assistance or custom enterprise limits?
Check real-time gateway status or reach out to support for reseller keys and custom quotas.