User Guide

第一次使用 MonkeyAI,按以下 4 步完成接入。

首次接入时无需阅读全部文档。建议先获取 API Key、确认 Base URL、完成第一条请求验证,再接入客户端或编程工具。

主 Base URL: https://monkeytheme.com/v1 备用 Base URL: https://monkeytheme.com/v1 Authorization: Bearer sk-你的APIKey 推荐入门模型: gpt-4o-mini

先记住这组配置

Base URL: https://monkeytheme.com/v1 备用 Base URL: https://monkeytheme.com/v1 Authorization: Bearer sk-你的APIKey 推荐模型: gpt-4o-mini

大多数情况下,API Key、Base URL、Model 三项填对,即可完成初始验证。

第一次使用,按以下 4 步操作

第 1 步:注册 / 登录

先进入 MonkeyAI 注册并登录控制台。

第 2 步:创建 API Key

到 API Keys 页面新建一个 key。注意,key 通常只会完整显示一次,创建后就先保存好。

第 3 步:验证第一条请求

curl https://monkeytheme.com/v1/chat/completions \ -H "Authorization: Bearer sk-你的APIKey" \ -H "Content-Type: application/json" \ -d '{ "model":"gpt-4o-mini", "messages":[{"role":"user","content":"Hello MonkeyAI"}] }'

第 4 步:再接入客户端或工具

普通聊天客户端看 客户端配置教程;Cursor、Claude Code、Codex 这些看 编程工具配置教程。

大多数客户端怎么填

API Key: sk-你的APIKey Base URL: https://monkeytheme.com/v1 Model: gpt-4o-mini
如果客户端会自动补 /v1,那就改填 https://monkeytheme.com。

模型怎么选

通用入门: gpt-4o-mini 高质量复杂任务: gpt-4o 编程 Agent: gpt-4o / gpt-4o Claude 风格: claude-sonnet-4-20250514-20250514 / claude-3-opus-latest 低成本批量: deepseek-chat 图片生成: gpt-image-2

第一天的建议

建议先用轻量模型完成流程验证,再根据需要切换高质量模型。

常见错误

401 / API key invalid

一般是 Authorization 头没带好,或者 key 复制时带了空格/换行。

404 / 路径错误

多半是 /v1 重复了,写成了 /v1/v1。

model not found

请先查询模型列表,确认当前账号可用的完整模型名:

curl https://monkeytheme.com/v1/models \ -H "Authorization: Bearer sk-你的APIKey"

429 / 503

429 是请求太快;503 是上游临时不可用。先降并发,或者换个模型再试。

安全提醒

  • 不要把完整 API Key 发给任何人。
  • 截图时把 key 中间遮掉。
  • 如果 key 泄露,立刻删除旧 key 重建。
  • 正式项目建议一个项目一个 key。
最省心的习惯:先测 API,再接客户端;一个项目一个 key;一个工具一个 key。