OpenAI-Compatible Proxy

Quick start

Send a chat completion with curl:

curl https://aipass.one/apikey/v1/chat/completions \
  -H "Authorization: Bearer sk-aikey-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

The response is identical to the OpenAI response format — your existing parsing code works as-is.

Authentication

Pass your AI Pass API key in the Authorization header as a Bearer token:

Authorization: Bearer sk-aikey-YOUR_KEY

Your key is validated against your account balance. Requests are rejected with 403 if the key is invalid, revoked, or your balance is exhausted.

Create and manage keys in the Developer Dashboard. Each key maps to a LiteLLM virtual key internally — the model provider never sees your AI Pass key.

Supported endpoints

The proxy allowlists these paths. Requests to any other path return 403 Endpoint not allowed.

Available models

Fetch the live model list from the proxy — this reflects exactly what your key can access:

curl https://aipass.one/apikey/v1/models \
  -H "Authorization: Bearer sk-aikey-YOUR_KEY"

// Response:
{
  "object": "list",
  "data": [
    { "id": "gpt-4o",      "object": "model", "owned_by": "openai" },
    { "id": "gpt-4o-mini", "object": "model", "owned_by": "openai" },
    { "id": "claude-sonnet-4-6", "object": "model", "owned_by": "openai" },
    ...
  ]
}

Models are routed through LiteLLM. Claude, Gemini, and other providers are listed using their LiteLLM model IDs.

Streaming

Set "stream": true in the request body. The proxy detects this automatically and returns a standard SSE stream:

curl https://aipass.one/apikey/v1/chat/completions \
  -H "Authorization: Bearer sk-aikey-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to 5"}]
  }'

// Response (SSE):
data: {"choices":[{"delta":{"content":"1"},...}]}
data: {"choices":[{"delta":{"content":","},...}]}
...
data: [DONE]

Integration examples

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://aipass.one/apikey/v1",
    api_key="sk-aikey-YOUR_KEY",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

JavaScript / TypeScript (openai SDK)

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://aipass.one/apikey/v1',
  apiKey: 'sk-aikey-YOUR_KEY',
})

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [{ role: 'user', content: 'Hello!' }],
})
console.log(response.choices[0].message.content)

LangChain (Python)

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o-mini",
    base_url="https://aipass.one/apikey/v1",
    api_key="sk-aikey-YOUR_KEY",
)

result = llm.invoke("What is the capital of France?")
print(result.content)

Cursor, Claude Code, and other agent tools

Any tool that accepts a custom OpenAI base URL works. Set:

OPENAI_BASE_URL=https://aipass.one/apikey/v1
OPENAI_API_KEY=sk-aikey-YOUR_KEY

Most tools (LiteLLM, LlamaIndex, Vercel AI SDK, CrewAI, AutoGen, etc.) read these environment variables automatically.