MaiToken
登录/注册

配置前准备

1. 配置前准备

1.1 准备好三个参数

Base URL https://api\.maitoken\.com/v1
完整聊天请求 URL https://api\.maitoken\.com/v1/chat/completions
Responses 请求 URL https://api\.maitoken\.com/v1/responses （Codex 使用）
Anthropic 请求 URL https://api\.maitoken\.com/v1/messages （Claude Code 使用）
API Key 在 MaiToken 用户控制台创建；示例写作 <你的 MaiToken Key>
模型 ID 从 Key 的模型展开列表或 GET /v1/models 返回结果中复制

1.2 创建 Key，并找到模型 ID

  1. 登录控制台：打开 MaiToken 用户控制台并登录自己的账号。

  2. 进入 API Keys：在左侧菜单找到 API Keys。

  3. 创建或编辑 Key：单击“创建 API Key”，或者编辑已有的 Key。Key 创建完成后请立即复制并妥善保存。

  4. 查看模型展开列表：在创建或编辑页面找到“令牌分组”。分组下的展开列表里显示的字符串就是这个 Key 可以调用的模型 ID。

  5. 复制模型 ID：完整复制，注意大小写、短横线和版本号。不要复制模型的中文展示名称。

模型 ID 示例： 例如平台显示 model.id 为 abc-model-2026，那么配置框里就填 abc-model-2026。不要填写“GPT”“Claude”这类系列名称。

1.3 Base URL 和完整 URL 怎么选

界面字段写法 应该填写 不要填写
Base URL / API Host / API 地址 https://api\.maitoken\.com/v1 不要再加 /chat/completions
完整 URL / Request URL / Endpoint URL https://api\.maitoken\.com/v1/chat/completions 不要只填到 /v1
判断口诀 看到 Base、Host、API 地址，就填到 /v1；看到完整 URL、Request URL、Endpoint URL，就填到 /v1/chat/completions。

2. 先做接口自检

如果接口自检都失败，先不要配置客户端。下面命令中的 Key 和模型 ID 必须替换。

2.1 macOS / Linux

export MAITOKEN_API_KEY="<你的 MaiToken Key>"export MAITOKEN_MODEL="<模型ID>" curl -sS https://api.maitoken.com/v1/models \  -H "Authorization: Bearer $MAITOKEN_API_KEY"
curl -sS https://api.maitoken.com/v1/chat/completions \  -H "Authorization: Bearer $MAITOKEN_API_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"'"$MAITOKEN_MODEL"'","messages":[{"role":"user","content":"只回复 OK"}],"stream":false}'

2.2 Windows PowerShell

$env:MAITOKEN_API_KEY="<你的 MaiToken Key>"$env:MAITOKEN_MODEL="<模型ID>" Invoke-RestMethod https://api.maitoken.com/v1/models `  -Headers @{Authorization="Bearer $env:MAITOKEN_API_KEY"}
$body = @{  model = $env:MAITOKEN_MODEL  messages = @(@{role="user"; content="只回复 OK"})  stream = $false} | ConvertTo-Json -Depth 5 Invoke-RestMethod https://api.maitoken.com/v1/chat/completions `  -Method Post `  -Headers @{Authorization="Bearer $env:MAITOKEN_API_KEY"} `  -ContentType "application/json" `  -Body $body

2.3 如何判断结果

返回模型列表 Key 有效，并且可以读取模型权限。
返回 OK 或正常回答 Chat Completions 接口可用，可以开始配置客户端。
401 / Unauthorized Key 错误、已失效，或者 Authorization 格式不正确。
404 / Not Found 地址路径写错，常见原因是重复拼接 /v1/v1。
model_not_found 模型 ID 不正确，或该 Key 没有这个模型权限。