Quick Start

第一次接入,只做这 5 步。

本页面说明接入 MonkeyAI 所需的三项配置:API Key、Base URL 和模型名。确认这三项后,再接入客户端或编写代码。

Base URL: https://monkeytheme.com/v1 API Key: sk-*** 先测: GET /v1/models 再测: POST /v1/chat/completions
Step 1

注册账号

打开 MonkeyAI 首页,点右上角 立即开始 或 注册使用。如果你已经有账号,直接登录。

检查点:你应该能进入控制台,或者至少到达登录后的账户页面。
Step 2

充值余额

在控制台先确认账户有可用余额。很多“接口失败”并非配置错误,而是账户没有可用额度。

  1. 进入余额或充值页面
  2. 完成充值
  3. 刷新页面确认余额已经到账
检查点:余额不是 0,再继续后面的 Key 创建和接口测试。
Step 3

创建 API Key

在控制台找到 Token / API Key / 令牌 相关入口,新建一个 Key。创建成功后,复制那串以 sk- 开头的密钥。

建议名称: my-first-key 保存原则: 复制后立即保存,离开页面后通常不会再次完整显示
Step 4

记住这 3 项配置

之后无论接入 Chatbox、Cherry Studio、OpenAI SDK,还是编程工具,其实都只是在填这 3 项:

Provider / 类型: OpenAI Compatible Base URL: https://monkeytheme.com/v1 API Key: sk-你的APIKey 推荐模型: gpt-4o-mini
最常见错误:把官网首页当成 API 地址,或者 Base URL 少了 /v1。
Step 5

先用 curl 验证接口,再接入其他工具

避免直接配置复杂客户端。先用最简单的 HTTP 请求确认 Key、模型名和接口都正常,排障会更高效。

先测模型列表

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

再测聊天接口

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": "请回复 OK"}] }'
检查点:如果你收到正常回复,说明整条调用链已经通了。后面接客户端和工具,只是在复用同一套配置。

下一步去哪

想接桌面客户端

去看 客户端配置。

想写代码调用

去看 API 参考。

想接编程工具

去看 编程工具与脚本。

遇到报错

去看 FAQ 与故障排查。