API Documentation

OdinClaw is OpenAI-compatible. If you already use the OpenAI SDK, you only need to change 2 lines.

Authentication

Authenticate all API requests by including your API key in the Authorization header.

http
Authorization: Bearer oc_live_your_key_here

Your API key can be found and managed in the API Keys section. Never share your key or commit it to version control.

Base URL

url
https://api.odinclaw.ai/v1

Quick Start

Choose your language. All examples use the same OpenAI SDK — just point it at OdinClaw.

Python

main.py
from openai import OpenAI

client = OpenAI(
    base_url="https://api.odinclaw.ai/v1",
    api_key="oc_live_your_key_here"
)

response = client.chat.completions.create(
    model="minimax-2.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is the capital of France?"}
    ],
    max_tokens=200
)

print(response.choices[0].message.content)

Node.js

main.ts
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.odinclaw.ai/v1',
  apiKey: 'oc_live_your_key_here',
});

const response = await client.chat.completions.create({
  model: 'minimax-2.5',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'What is the capital of France?' },
  ],
  max_tokens: 200,
});

console.log(response.choices[0].message.content);

cURL

request.sh
curl https://api.odinclaw.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer oc_live_your_key_here" \
  -d '{
    "model": "minimax-2.5",
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ],
    "max_tokens": 200
  }'

Endpoint Reference

POST/v1/chat/completions

Create a chat completion. Fully compatible with OpenAI's chat completions API.

ParameterTypeRequired
modelstringYes
messagesarrayYes
max_tokensintegerNo
temperaturefloatNo
streambooleanNo
GET/v1/models

List all available models.

bash
curl https://api.odinclaw.ai/v1/models \
  -H "Authorization: Bearer oc_live_your_key_here"
GET/v1/keys

List all API keys for your account.

bash
curl https://api.odinclaw.ai/v1/keys \
  -H "Authorization: Bearer oc_live_your_key_here"
POST/v1/keys

Create a new API key.

bash
curl https://api.odinclaw.ai/v1/keys \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer oc_live_your_key_here" \
  -d '{"name": "Production Key"}'
GET/v1/usage

Get token usage statistics. Query params: period (this_month | last_month | last_7_days)

bash
curl "https://api.odinclaw.ai/v1/usage?period=this_month" \
  -H "Authorization: Bearer oc_live_your_key_here"

Available Models

minimax-2.5

MiniMax 2.5 · 128K ctx

$0.30/M tokens
deepseek-v3

DeepSeek V3 · 64K ctx

$0.14/M tokens
llama-3.3-70b

Llama 3.3 70B · 128K ctx

Free
qwen-3-80b

Qwen 3 80B · 32K ctx

Free