Dashboard
Tokens
Models
Documentation
Generate Image
Voice & Translation
Providers Status
Total Models
—
Chat + Image
Active Tokens
—
In rotation
Accounts
—
In pool
Image Generation
—
Available
Live Token Pool
EmailTypeExpires InStatus
📋 Account Management
EmailPasswordAddedStatusActions
🚀 Batch Registration

API Integration

OpenAI Chat Completions

Seamlessly integrate with OpenAI-compatible clients using your existing codebases.

POST/v1/chat/completions
curl -X POST http://HOST:3077/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

Anthropic Messages

Compatible with Anthropic's Messages API

POST/v1/messages
curl -X POST http://HOST:3077/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

OpenAI Responses

Compatible with OpenAI's Responses API

POST/v1/responses
curl -X POST http://HOST:3077/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1-mini",
    "input": "Explain quantum computing"
  }'

Image Generation

Compatible with OpenAI's Image Generation API

POST/v1/images/generations
curl -X POST http://HOST:3077/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A serene mountain landscape at sunset",
    "n": 1,
    "size": "1024x1024"
  }'

Real-time Voice & Audio

Seamlessly integrate real-time voice sessions using xAI's Grok Voice (WebSocket-based) or OpenAI's GPT Realtime Voice (WebRTC-based).

1. OpenAI / GPT Realtime (WebRTC)

Acquire an ephemeral session token, then perform a raw Session Description Protocol (SDP) handshake via the gateway proxy.

POST/voice/token — Request Session Token
curl -X POST http://HOST:3077/voice/token \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "sessionConfig": {
      "model": "gpt-realtime-2.1",
      "voice": "alloy",
      "instructions": "You are a helpful assistant."
    }
  }'
POST/v1/realtime/calls?model=gpt-realtime-2.1 — SDP Handshake Proxy
curl -X POST http://HOST:3077/v1/realtime/calls?model=gpt-realtime-2.1 \
  -H "Content-Type: application/sdp" \
  -H "Authorization: Bearer EPHEMERAL_TOKEN_FROM_STEP_1" \
  -d "v=0
o=- 2342342 2342342 IN IP4 127.0.0.1
s=-
t=0 0
..."

2. xAI / Grok Realtime (WebSocket)

Retrieve dynamic session credentials, then establish a WebSocket connection directly to the upstream real-time server.

POST/grok-voice/session — Create Grok Session
curl -X POST http://HOST:3077/grok-voice/session \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voice": "voice_id",
    "instructions": "You are Grok."
  }'
WebSocket Protocol Integration:
Establish a client WebSocket connection targeting:
wss://api.x.ai/v1/realtime?model=grok-voice-latest
Provide the `client_secret` value in the WebSocket protocols parameter:
new WebSocket(wsUrl, ["xai-client-secret.YOUR_SECRET"])
POST/grok-voice/session/end — End Grok Session
curl -X POST http://HOST:3077/grok-voice/session/end \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "sessionId": "SESSION_ID_FROM_STEP_1"
  }'

Management Endpoints

GET/v1/models — List all available models
GET/v1/images/models — List image models
GET/api/pool/stats — Pool statistics
GET/api/pool/accounts — List accounts
POST/api/pool/register — Auto-register new account
POST/api/pool/register/batch — Batch register
POST/api/pool/refresh — Force refresh tokens
DELETE/api/pool/accounts/:email — Remove account

Image Generation Demo

Enter a prompt and generate an image

Voice & Real-time Translation

Voice session offline

Upstream Model Provider Diagnostics

Live service monitoring, latency metrics, and real-time diagnostic probes

Upstream Gateway
Connecting...
api.badland.ai
Response Latency
— ms
Round-trip ping
DB Connection Pool
—
MongoDB Cluster
Total Upstream Models
—
Across all providers

Provider Health Breakdown

Live Diagnostic Probe Results
Not run yet
Target Service / ProviderEndpoint / LayerLatencyStatusDiagnostics Detail
Click "Run Diagnostic Probe" to execute a live service test
Raw Upstream Diagnostic Payload (JSON)
Show JSON