OpenAI 兼容 API 网关说明
把 OpenAI 形态的 SDK 与编程代理指到 https://monkeytheme.com/v1，用 MonkeyAI Key 鉴权，再用 GET /v1/models 确认 model id。兼容讲的是 HTTP 形态与鉴权，不是对所有厂商专有能力的空白承诺。
直接结论
OpenAI 兼容 API 网关让已经按 OpenAI HTTP 形态接入的工具，把主机指到另一处。MonkeyAI 上该地址是 https://monkeytheme.com/v1：仍是 Bearer 鉴权与 /v1/... 路径风格，模型路由在网关后完成。
| 项 | MonkeyAI 取值 |
|---|---|
| 公网 Base URL | https://monkeytheme.com/v1（包含 /v1） |
| 鉴权（实测错误文案） | Authorization: Bearer，或 x-api-key，或 x-goog-api-key |
| 安全首检 | 带 Key 调用 GET /v1/models |
| 本文主机名 | 仅 monkeytheme.com |
生产实测（未使用真实用户 Key）
探测目标为公网 https://monkeytheme.com，日期 2026-08-04。未使用任何客户 Key。正文为线上响应摘要。
| 请求 | HTTP | 信号 | 说明 |
|---|---|---|---|
GET /v1/models（无鉴权） | 401 | API_KEY_REQUIRED | 模型列表接口在鉴权后可用 |
POST /v1/chat/completions（无鉴权） | 401 | API_KEY_REQUIRED | Chat Completions 路径存在 |
POST /v1/responses（无鉴权） | 401 | API_KEY_REQUIRED | Responses 路径存在 |
POST /v1/messages（无鉴权） | 401 | API_KEY_REQUIRED | Messages 形态路径同样进入鉴权层 |
GET /models（站点根，无 /v1） | 404 | nginx HTML | 缺 /v1 时不是 API |
/v1/models 为准。什么时候适合用网关
适合
- 已支持自定义 Base URL 的 SDK 与代理
- 希望用一把 Key 表面覆盖多个模型族
- Codex CLI、Cline、Roo Code、Hermes 等 OpenAI 兼容编程工具
- 需要统一处理 401 / 429 / 504 的应用
先核对
- 硬编码 Anthropic 字段名的 Claude 专用客户端
- 只存在于某一厂商专有面的功能
- 会静默重复或剥掉
/v1的客户端 - 任何你没在
/v1/models见过的模型 id 宣传
可落地的接入顺序
- 在 MonkeyAI 控制台创建 Key，勿写入 git 与聊天记录。
- Base URL 设为
https://monkeytheme.com/v1，不要只填网站根地址。 - 执行
GET /v1/models；Key 有效时应返回 JSON 列表。 - 模型 id 与列表完全一致（大小写与符号都算）。
- 再发一次短
/v1/chat/completions。 - 最后才配置 Codex CLI、Cline、Roo Code、Hermes 或自有应用，使用同一 Base URL + Key + model id。
# 1) 验证鉴权与路由（将 *** 换成 Key；切勿提交真实密钥）
curl -sS https://monkeytheme.com/v1/models \
-H "Authorization: Bearer ***" | head -c 800
# 2) models 通过后再做一次短对话
curl -sS https://monkeytheme.com/v1/chat/completions \
-H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":32}'
# 3) 对照：缺 /v1 的根路径 /models 不是 API
curl -sS -o /dev/null -w "%{http_code}\n" https://monkeytheme.com/models
「兼容」通常对应什么
| 客户端预期 | MonkeyAI 常见映射 |
|---|---|
OpenAI SDK base_url / baseURL | https://monkeytheme.com/v1 |
api_key | MonkeyAI 控制台 Key |
GET .../models | https://monkeytheme.com/v1/models |
| Chat Completions | https://monkeytheme.com/v1/chat/completions |
| Responses 形态客户端 | https://monkeytheme.com/v1/responses（路径已鉴权；能力深度需自行测） |
| 模型选择 | 每次请求的 model id，来自可见列表 |
对 Anthropic 形态工具，不要假设字段与 OpenAI 名称可 1:1 互换。Messages 优先的客户端请看 Claude Code 网关教程。
网关用户最先遇到的故障类型
| 现象 | 更可能的类型 | 第一步 |
|---|---|---|
401 API_KEY_REQUIRED | 没有可接受的 Key 头到达 API | 修环境变量/导出/请求头；见 401 教程 |
401 INVALID_API_KEY | 有值但被拒绝 | 重拷 Key；确认主机为 monkeytheme.com |
/models 返回 404 HTML | Base URL 缺 /v1 | 改用 https://monkeytheme.com/v1；见 Base URL 教程 |
| Model not found | 鉴权已过；id 错误或未授权 | 重读 /v1/models |
| 429 | 限流或额度 | 遵循 Retry-After；见 429 教程 |
| 504 / 客户端超时 | 上游或等待预算 | 见 504 / SDK 超时教程 |
安全与运维习惯
- Key 放在服务端或可信本地环境变量，不要写进公开前端包。
- 需要清晰吊销时，按人或按服务拆分 Key。
- 升级工单时提供接口、UTC 时间、HTTP 状态、JSON
code/message与请求 id（如有），不要发完整 Key。 - 改代理配置后重启进程或开新会话，确保新 Base URL 真的加载。
常见问题
MonkeyAI 是 OpenAI 兼容 API 网关吗？
对常见 OpenAI 形态客户端：是。公网 Base URL 为 https://monkeytheme.com/v1。2026-08-04 对 /v1/models、/v1/chat/completions、/v1/responses、/v1/messages 的未鉴权探测均返回 HTTP 401，code 为 API_KEY_REQUIRED，说明这些路径在该主机上存在且会走鉴权。
Base URL 要不要带 /v1？
对会拼接 /models、/chat/completions 的 OpenAI 兼容客户端与 SDK：要。请使用 https://monkeytheme.com/v1。同日探测中，访问 https://monkeytheme.com/models（无 /v1）返回 nginx 的 HTTP 404 HTML。
用了网关还需要填模型名吗？
需要。Base URL 与 API Key 只负责鉴权层是否接受请求。你仍要发送账号可见的 model id。接入真实 Key 后，以 GET /v1/models 列表为准。
一把 Key 能通过网关调 GPT 和 Claude 吗？
一把 MonkeyAI Key 用于网关鉴权。具体哪些 GPT / Claude id 可用，取决于账号与分组开通情况。不要自造昵称；从 /v1/models 复制精确 id。多模型流程见「一把 Key 同时用 GPT 与 Claude」教程。
OpenAI 兼容不保证什么？
不保证每个 Claude 原生客户端字段、每一项 Responses 专有能力，或每个编程代理的工具循环都能零改造跑通。兼容指常见的 /v1 形态与鉴权方式，不是对所有厂商专有面的空白支票。