身份认证

所有对 ModelMax 的 API 请求都需要通过 Authorization 请求头传递 API 密钥进行认证。

API 密钥

创建密钥

1. 使用 Google 账号登录 ModelMax 控制台。
2. 前往 设置 → API 密钥。
3. 点击 创建 API 密钥 并填写描述性名称。
4. 立即复制密钥 — 之后将不再显示。

使用密钥

在 Authorization 请求头中以 Bearer token 形式传递密钥：

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",
});

错误响应

详见错误处理。