API Documentation

Complete API reference for OpenAI-compatible, Claude-compatible, and native endpoints.

Choose your preferred API style. We support native, OpenAI-compatible, and Claude-compatible endpoints.

Model names (e.g., gpt-3.5-turbo, gpt-4, gpt-4.1, gpt-5, gpt-5.1, claude-3-5-sonnet) automatically map to equivalent AI Badgr models for seamless compatibility.

Endpoint: POST /api/v1/chat/completions

Drop-in replacement for OpenAI. Just change the base URL.

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://aibadgr.com/api/v1"
)

response = client.chat.completions.create(
    model="gpt-3.5-turbo",
    messages=[
        {"role": "user", "content": "Hello!"}
    ],
    max_tokens=200
)

print(response.choices[0].message.content)
base_url — Change this from default OpenAI URL
JavaScript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://aibadgr.com/api/v1'
});

const response = await client.chat.completions.create({
  model: 'gpt-3.5-turbo',
  messages: [
    { role: 'user', content: 'Hello!' }
  ],
  max_tokens: 200
});

console.log(response.choices[0].message.content);
baseURL — Change this from default OpenAI URL
cURL
curl https://aibadgr.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_tokens": 200
  }'
https://aibadgr.com/api/v1 — Change this from https://api.openai.com/v1