o3-mini

o3-mini — Free API Specifications

How to Configure o3-mini for Free

One-Click Config for Claude Code, Cursor & More

# Claude Code works via OpenRouter's Anthropic-compatible API.
# Note: Only paid Anthropic Claude models are supported (e.g. claude-sonnet-4.6, claude-opus-4).
# Browse available Claude models at: https://openrouter.ai/models?q=anthropic

# Add to ~/.zshrc or ~/.bashrc
export OPENROUTER_API_KEY="<your-openrouter-api-key>"  # Get at https://openrouter.ai/settings/keys
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""  # Must be explicitly empty to avoid conflicts

# Optional: pin specific models for each role
# export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
# export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

# Then simply run: claude

# Cursor → Settings (⚙️) → Models → Add Model
# Enter the model name exactly as shown, then fill in:
#   Override OpenAI Base URL: https://models.inference.ai.azure.com
#   OpenAI API Key: <your-api-key>   # Get at https://github.com/marketplace/models
# Click "Verify" to confirm the connection, then enable the model.
#
# Model name to add: o3-mini

# Add to ~/.zshrc or ~/.bashrc
export OPENAI_BASE_URL="https://models.inference.ai.azure.com"
export OPENAI_API_KEY="<your-api-key>"  # Get at https://github.com/marketplace/models

# Then run:
codex --model "o3-mini"

# ~/.gemini/settings.json
{
  "apiKey": "<your-api-key>",
  "model": "o3-mini"
}
# Get API key at https://github.com/marketplace/models

// ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "free-llm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Free LLM",
      "options": {
        "baseURL": "https://models.inference.ai.azure.com",
        "apiKey": "<your-api-key>"
      },
      "models": {
        "o3-mini": { "name": "o3-mini" }
      }
    }
  }
}
// Get API key at https://github.com/marketplace/models

# Step 1 — Edit config.yaml
# Windows: C:\Users\<you>\AppData\Local\hermes\config.yaml
# macOS/Linux: ~/.config/hermes/config.yaml

model:
  default: o3-mini
  provider: custom
  base_url: ${CUSTOM_BASE_URL}
  api_key: ${CUSTOM_API_KEY}
  model_aliases:
    o3-mini:
      model: "o3-mini"
      provider: "custom"

# Step 2 — Edit .env (same directory as config.yaml)
# Windows: C:\Users\<you>\AppData\Local\hermes\.env
# macOS/Linux: ~/.config/hermes/.env

# ========================
# Custom API (OpenAI-compatible)
# ========================
CUSTOM_API_KEY=<your-api-key>        # Get at https://github.com/marketplace/models
CUSTOM_BASE_URL=https://models.inference.ai.azure.com

// ~/.openclaw/openclaw.json  (JSON5 format)
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "o3-mini",
      },
    },
  },
  "models": {
    "providers": {
      // Option A — Built-in provider (OpenAI, Anthropic, Google…)
      // Just add apiKey; OpenClaw handles the baseUrl automatically
      // "openai": { "apiKey": "<your-api-key>" },

      // Option B — Custom OpenAI-compatible base URL (e.g. OpenRouter, NVIDIA)
      "free-llm": {
        "baseUrl": "https://models.inference.ai.azure.com",
        "apiKey": "<your-api-key>",  // Get at https://github.com/marketplace/models
        "api": "openai-completions", // openai-completions | anthropic-messages | …
        "models": [
          { "id": "o3-mini", "name": "o3-mini" },
        ],
      },
    },
  },
}
// Apply: openclaw gateway restart
// Verify: openclaw doctor --fix