Developer setup

MiraiAPI 接続ガイド

OpenAI-compatible は https://api.miraiapi.com/v1、Claude Code の Anthropic-compatible は https://api.miraiapi.com を使います。

Available modelsgpt-5.5, gpt-5.5-xhigh, gpt-5.5-high, gpt-5.4, gpt-5.3-codex, gpt-5.3-codex-xhigh, gpt-5.3-codex-high, claude-opus-4.6, kimi-k2.6

Claude Code CLI

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_BASE_URL": "https://api.miraiapi.com",
    "API_TIMEOUT_MS": "3000000",
    "DISABLE_TELEMETRY": "1",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
    "CLAUDE_CODE_MAX_RETRIES": "20",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.5-xhigh",
    "CLAUDE_CODE_SUBAGENT_MODEL": "gpt-5.5"
  },
  "model": "sonnet",
  "theme": "auto",
  "disableLoginPrompt": true
}

重要: Claude Code は自動で /v1/messages を付けるため、ANTHROPIC_BASE_URL に /v1 を付けません。

Codex CLI

~/.codex/config.toml + ~/.codex/auth.json

~/.codex/config.toml

model = "gpt-5.3-codex"
model_provider = "miraiapi"

[model_providers.miraiapi]
name = "miraiapi"
base_url = "https://api.miraiapi.com/v1"
wire_api = "responses"

~/.codex/auth.json

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-..."
}

Codex は OpenAI-compatible endpoint を使うため、Base URL は必ず /v1 付きです。

OpenClaw

Custom provider

Provider miraiapi を追加します。既定の openai provider は変更しません。

export default {
  providers: {
    miraiapi: {
      api: "openai-completions",
      baseUrl: "https://api.miraiapi.com/v1",
      apiKey: process.env.MIRAI_API_KEY,
      models: [
        { id: "gpt-5.3-codex" },
        { id: "gpt-5.3-codex-high" },
        { id: "gpt-5.3-codex-xhigh" },
        { id: "gpt-5.5" },
        { id: "gpt-5.5-xhigh" }
      ]
    }
  },
  agents: { defaults: { model: { primary: "miraiapi/gpt-5.3-codex" } } }
}

OpenClaw で呼ぶ model は miraiapi/gpt-5.3-codex の形式です。

Hermes Agent

~/.hermes/config.yaml

model:
  provider: custom
  base_url: https://api.miraiapi.com/v1
  name: gpt-5.3-codex

env:
  OPENAI_API_KEY: sk-...

CLI config

hermes config set model.provider custom
hermes config set model.base_url https://api.miraiapi.com/v1
hermes config set model.name gpt-5.3-codex
hermes config set OPENAI_API_KEY sk-...

curl

/v1/chat/completions と /v1/models

Chat completions

curl https://api.miraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.3-codex","messages":[{"role":"user","content":"ping"}],"max_tokens":64}'

Available models

curl https://api.miraiapi.com/v1/models \
  -H "Authorization: Bearer sk-..."