Quickstart

OpenGateway is a drop-in base URL. You bring your existing client or SDK, point it at a lane, and authenticate with a single OpenGateway key.

1. Set your key.

   export OPENGATEWAY_API_KEY="YOUR_KEY"

   Send it as Authorization: Bearer $OPENGATEWAY_API_KEY (OpenAI style) or x-api-key: $OPENGATEWAY_API_KEY (Anthropic style). Both work on every route. Never send upstream provider keys.

2. Pick a lane. Start on /oss — the curated open-weight coding catalog. See Lanes for the rest (/hf, /frontier, /pro).

3. Make your first request.

   curl

   curl "https://api.opengateway.one/oss/v1/chat/completions" \
     -H "Authorization: Bearer $OPENGATEWAY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "claude-turbo-hub-qwen3-coder",
       "messages": [{ "role": "user", "content": "Say PONG only." }]
     }'

   OpenAI (Python)

   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://api.opengateway.one/oss/v1",  # includes /v1
       api_key="YOUR_KEY",
   )
   resp = client.chat.completions.create(
       model="claude-turbo-hub-qwen3-coder",
       messages=[{"role": "user", "content": "Say PONG only."}],
   )
   print(resp.choices[0].message.content)

   OpenAI (TS)

   import OpenAI from 'openai';
   
   const client = new OpenAI({
     baseURL: 'https://api.opengateway.one/oss/v1', // includes /v1
     apiKey: process.env.OPENGATEWAY_API_KEY,
   });
   const resp = await client.chat.completions.create({
     model: 'claude-turbo-hub-qwen3-coder',
     messages: [{ role: 'user', content: 'Say PONG only.' }],
   });
   console.log(resp.choices[0].message.content);

   Anthropic (TS)

   import Anthropic from '@anthropic-ai/sdk';
   
   const client = new Anthropic({
     baseURL: 'https://api.opengateway.one/oss', // NO /v1 — SDK appends it
     apiKey: process.env.OPENGATEWAY_API_KEY,
   });
   const msg = await client.messages.create({
     model: 'claude-turbo-hub-qwen3-coder',
     max_tokens: 256,
     messages: [{ role: 'user', content: 'Write a TS debounce helper.' }],
   });
   console.log(msg.content);

4. Point your coding agent. Jump to Client setup for copy-paste config for Claude Code, Codex, OpenCode, Cursor, and Cline/Roo.

The /v1 gotcha

The OpenAI SDK base URL includes /v1 (https://api.opengateway.one/oss/v1). The Anthropic SDK base URL excludes it (https://api.opengateway.one/oss) because the SDK appends its own /v1/messages. Both land on the gateway’s /v1/* routes.

Preview host

During preview the host is https://preview.api.opengateway.one. Swap the host and keep the lane + path identical.

Discover models

curl "https://api.opengateway.one/oss/v1/models" \
  -H "Authorization: Bearer $OPENGATEWAY_API_KEY"

See Model discovery for the dual-shape response and how each client uses it.