認証

ModelMax へのすべての API リクエストでは、Authorization ヘッダーに API キーを渡して認証する必要があります。

API キー

キーの作成

1. Google アカウントで ModelMax ダッシュボード にサインインします。
2. Settings → API Keys に移動します。
3. Create API Key をクリックし、識別しやすい名前を付けます。
4. キーをすぐにコピーしてください。再表示はされません。

キーの使用

Bearer token として Authorization ヘッダーに渡します。

curl https://api.modelmax.io/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "gemini-3-flash-preview", "messages": [{"role":"user","content":"hi"}] }'

OpenAI SDK を使う場合は api_key として設定します。

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.modelmax.io/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.modelmax.io/v1",
});

キーの取り消し

ダッシュボード、または管理 API からキーを削除できます。

curl -X DELETE https://api.modelmax.io/api/keys/{keyID} \
  -H "Cookie: session=..."

取り消されたキーは即座に拒否されます。

環境変数

キーは環境変数に保存することを推奨します。

export MODELMAX_API_KEY="sk-your-api-key"

コードから参照します。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MODELMAX_API_KEY"],
    base_url="https://api.modelmax.io/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MODELMAX_API_KEY,
  baseURL: "https://api.modelmax.io/v1",
});

エラーレスポンス

詳細はエラー処理を参照してください。