先跑通一条真实请求,再继续接入客户端和工具。

这页文档中心按真实用户路径组织:先快速开始,再看客户端配置,然后按编程工具或 Agent 场景进入对应专题。

Base URL: https://monkeytheme.com/v1OpenAI Compatible文档 + 工具 + 排障

先从这里开始

如果用户只想走最短路径,优先让他看快速开始、API 参考和客户端配置。

快速开始

创建 API Key,填 Base URL,先跑通一条请求,再继续下一步。

打开指南 →

API 参考

接口地址、鉴权方式、请求示例,以及真实模型命名规则。

打开指南 →

客户端配置

Chatbox、Cherry Studio、SDK、自定义应用分别该填什么。

打开指南 →

先完成一条真实请求测试

这些工具可帮助排查最常见的 Base URL、API Key、模型名和配置格式问题,再决定继续接哪个客户端。

接口测试器

先验证 Base URL、API Key、模型名和 OpenAI Compatible 返回是否真的可用。

打开工具 →

配置生成器

给 Hermes、OpenClaw、Codex、Cline、Roo Code 等客户端生成更稳的配置模板。

打开工具 →

模型推荐器

按编程、Agent、速度、成本偏好,先选一个更适合当前任务的模型。

打开工具 →

推荐阅读顺序

根据访问者真正想做的事,给他更短的阅读路径。

新接入用户

快速开始 → API 参考 → 客户端配置

打开路径 →

Agent / 编程工具用户

Agent 接入中心 → 对应专题 → 工具页

打开路径 →

按工具和场景进入

若用户来自编程工具或 Agent 客户端,无需跳转至泛首页,直接进入对应入口页即可。

Agent 接入中心

Hermes Agent、OpenClaw、Codex CLI、Claude Code、Cline、Roo Code 的统一入口。

打开中心 →

编程工具

面向编程型客户端的设置说明、协议差异和可运行示例。

打开指南 →

Agent 工具箱

先用接口测试、配置生成、模型推荐,再让用户注册或切配置。

打开工具 →

搜索型专题

这些页面专门回答用户在注册前最常搜的具体问题。

OpenAI Python SDK 自定义 Base URL

用官方 SDK 实测模型发现、401、连接错误、重试和超时边界。

打开中文教程 →

Anthropic Python SDK 自定义 Base URL

用官方 Anthropic Python SDK 指向 MonkeyAI:base_url 配置、x-api-key 探测、client.messages.create() 实跑,2026-08-09 实测。

打开中文教程 →

Anthropic Node.js SDK 自定义 baseURL

用 @anthropic-ai/sdk 指向 MonkeyAI:baseURL 配置、x-api-key 探测、Node 流式和错误处理,与 Python SDK 共用同一套 wire 协议。

打开中文教程 →

Cherry Studio 与 Chatbox 接入 MonkeyAI

将 Cherry Studio 与 Chatbox 作为 OpenAI 兼容 provider 接入 MonkeyAI:API Host、API Key、模型下拉、视觉输入、流式输出,以及常见的 401 / 404 排错。2026-08-09 生产实测。

打开中文教程 →

OpenAI Node.js SDK 自定义 Base URL

使用官方 JavaScript SDK 配置 baseURL、模型检查、接口解析、重试和请求 ID。

打开中文教程 →

Responses API 与 Chat Completions

对比接口字段、响应解析、会话状态和兼容性验证,避免只改 URL 就上线。

打开中文教程 →

OpenAI 兼容 API 429 限流排错

区分请求限制与余额错误,正确处理 Retry-After,并避免 SDK 与应用层重复重试。

打开中文教程 →

OpenAI Compatible SSE 流式输出

用 Python、Node.js 和 curl 接收流式事件,并排查缓冲、401、404 与超时。

打开中文教程 →

OpenAI SDK 超时、重试与 Request ID

区分客户端超时与 HTTP 504,配置 Python 和 Node 重试,并保留可用的 request ID。

打开中文教程 →

OpenAI 兼容客户端清单

对比 Cline、Roo Code、Codex CLI、Hermes 与 SDK 的配置字段和协议边界。

打开中文教程 →

Hermes Agent 接入 OpenAI 兼容 API

按当前 Custom Endpoint 流程配置 provider,区分终端向导与聊天内模型切换。

打开中文教程 →

Codex CLI 切第三方 API

如何切 Codex CLI,又不把版本支持和配置方式混在一起。

打开中文教程 →

Codex CLI API Key 实测配置

先验证 Key,再用独立 Profile 接入 MonkeyAI,不覆盖现有 Codex 配置。

打开中文教程 →

API Base URL 与 /v1

根据 401 JSON、404 HTML 和重复 /v1 判断客户端路径是否正确。

打开中文教程 →

Cline / Roo Code 接入

按官方 OpenAI Compatible 字段填写 Base URL、Key 和 Model ID,并区分 Roo 的工具调用要求。

打开中文教程 →

API 504 上游超时排错

区分 401 与 504,保留请求 ID 和时间证据,再做有限重试。

打开中文教程 →

API 502 Bad Gateway 排错

区分 502 与 504/503:用 latency 与上游日志形态(upstream_failover_switching vs account_select_failed)快速判断失败层,再决定是否重试或切换账号。

打开中文教程 →

API 401 Invalid Token 排错

区分 API_KEY_REQUIRED 与 INVALID_API_KEY,先用 /v1/models 探测 Key,再去改客户端配置。

打开中文教程 →

OpenAI 兼容 API 503 “no available accounts” 排错

区分上游账号池 503 与 401/429/504:先看 relay 日志里的 account_select_failed(2026-08-08 截取),再按 6 步恢复清单处理。

打开中文教程 →

Cryptomus USDT 充值未到账排错

诊断 PENDING、跳到 CANCELLED、始终不认账的 Cryptomus 订单:webhook 真实路径、400 missing-sign、生产 payment_orders 读法,以及给支持团队的证据清单。

打开中文教程 →

ChatGPT Plus 5 小时窗口 OAuth 账号池耗尽 503

诊断 ChatGPT Plus OAuth 滚动 5 小时窗口被打到零而中转返回 503:读 upstream_failover_switching 与 account_select_failed 日志(7 天 1,205 次 503、241 次上游 401,2026-08-08 截取),降并发并等滚动窗口慢慢恢复。

打开中文教程

Claude Code API Gateway 配置

核对 Anthropic Messages、Base URL、凭据头和模型发现,不把 OpenAI 兼容地址当成完整证明。

打开中文教程 →

Hermes / OpenClaw 五步接入

按"路由 → Key → 配置 → 重启 → 跑一条请求"五步顺序实测 MonkeyAI,再把 OpenAI 兼容 Base URL 接入 Hermes 或 OpenClaw。

打开中文教程 →

Claude Code 协议边界

Claude Code 默认走 Anthropic Messages(ANTHROPIC_BASE_URL + x-api-key),OpenAI 兼容地址不等于直接能接。先讲边界,再决定是否切到 Cline / Roo Code。2026-08-09 中文专题。

打开中文教程 →

Cline / Roo Code 接 OpenAI-Compatible API

这类扩展型编程客户端,最稳的接入路径是什么。

打开专题 →

Chat Completions function calling 在 OpenAI 兼容网关上的实战

按 OpenAI 官方 tools[].function 字段定义工具、解析 tool_calls、回传 role:tool 消息,并设置 tool_choice / parallel_tool_calls,最后用最小沙箱执行工具调用。

打开中文教程 →

Responses API function calling 在 OpenAI 兼容网关上的实战

用 strict-JSON 定义工具、解析 call_id、回传 function_call_output,复用 Chat Completions 的执行沙箱,又不混淆两个端点的字段命名。

打开中文教程 →

OpenAI 兼容 embeddings API

在 https://monkeytheme.com/v1 调用 POST /v1/embeddings:先从 /v1/models 拿到可用 model id,再用 401/404 实测确认鉴权与路径,最后写入 SDK。

打开中文教程 →

MonkeyAI 的 OpenAI 兼容接口覆盖

2026-08-09 实测 /v1 端点矩阵:哪些 OpenAI 风格路径返回 401(先鉴权、已支持),哪些返回 404 page not found(未开放),附带 x-api-key、x-goog-api-key、anthropic-version 三种请求头探测。

打开中文教程 →

AI API 网关开发者指南

用 MonkeyAI 做 OpenAI 兼容 API 网关的开发者流程:5 项接入前核对、6 步一次性跑通、真实 curl 探测(2026-08-08 /v1/models/chat-completions/responses/messages 鉴权 + /models 404 HTML)以及生产可用的运维习惯。

打开中文教程 →

AI API 价格对比

解读 MonkeyAI 实时 GPT / Claude / Gemini 价格:当前可见的 Codex / OpenAI 行、Claude 三档分组、百分比折扣算法,以及选模型前真正要对比的维度。数据于 2026-08-08 抓取。

打开教程

热门选择与单 Key 多模型

把"该选哪个模型"和"一把 Key 怎么同时用 GPT 和 Claude"这两类高频搜索意图集中放在一起,避免用户先注册再回头猜。

AI 编程 Agent 最佳模型

按任务类型(小改动 / 重构 / 调试 / 长 Agent),用生产 401 与 embeddings 实测对照 GPT / Claude / DeepSeek 在 MonkeyAI 的真实表现,再决定编程 Agent 切哪个模型。

打开中文教程 →

一把 API Key 同时用 GPT 与 Claude

用一把 MonkeyAI Key 同时接入 GPT 与 Claude 的 OpenAI 兼容客户端:生产 401 实测、接入顺序、模型 id 核对,以及 Anthropic Messages 与 Chat Completions 的切换点。

打开中文教程 →

OpenAI 兼容 API 网关说明

解释什么是 OpenAI 兼容 API 网关、MonkeyAI 如何暴露 https://monkeytheme.com/v1,以及改代理配置前的生产 401/404 实测:哪个端点先鉴权、哪个端点未开放。

打开中文教程 →

计费与排障

把价格说明和排障路径放在接入路径旁边,让用户尽量自助解决,而不是先找客服。

计费与价格

理解 token 计费、余额、用量记录以及价格口径。

打开指南 →

FAQ 与排障

处理 401、模型名错误、额度不足、超时和客户端配置错误。

打开指南 →

model not found 模型错误排查

使用同一 Key 查询模型列表,复制完整模型 ID,再检查 Base URL 与接口兼容性。

打开中文教程 →

API Key 与错误码排查

先用 /v1/models 判断 401、404、model not found 和超时,再修改客户端配置。

打开排错教程 →

Base URL

https://monkeytheme.com/v1