首页 / 文档 / Base URL /v1

API Base URL 到底要不要带 /v1?

通常要带。MonkeyAI 的标准值是 https://monkeytheme.com/v1。漏写 /v1 会进入网站路由,重复填写则会请求不存在的 /v1/v1。

401 JSON/v1/models
404 HTML/models
404/v1/v1/models
301/v1/models/

Base URL 和完整端点不是同一个字段

客户端会先读取 Base URL,再追加 /models、/responses 或 /chat/completions。Base URL 使用 https://monkeytheme.com/v1,拼接后才是正确 API 路径。

字段或请求填写值
Base URL / OpenAI Base URL / API Basehttps://monkeytheme.com/v1
模型列表端点https://monkeytheme.com/v1/models
Responses 端点https://monkeytheme.com/v1/responses
Chat Completions 端点https://monkeytheme.com/v1/chat/completions

生产端点的实测返回

以下检查在 2026-08-02 对生产环境执行,未使用真实 API Key。它们只验证路由,不把鉴权失败描述成模型调用成功。

请求实测返回含义
GET /200 HTML公开网站,不是 API 命名空间
GET /models404 HTML漏写 /v1
GET /v1/models401 JSON API_KEY_REQUIRED路由正确,需要认证
GET /v1/v1/models404重复填写 /v1
GET /v1/models/301 到 /v1/models尾部斜杠规范化
POST /v1/responses401 JSONResponses 路由正确
POST /responses404 HTML漏写 /v1

修改客户端前先测试路由

curl https://monkeytheme.com/v1/models \
  -H "Authorization: Bearer ***"

有效 Key 应返回该账号当前可见的模型列表。未带 Key 时,当前路由会返回 JSON API_KEY_REQUIRED。如果收到 HTML 或 404,应先修正路径。

什么时候可以填写根域

少数客户端要求填写账号主机,并自行追加 /v1。只有该客户端官方文档明确说明自动追加时,才填写 https://monkeytheme.com;其他情况使用 https://monkeytheme.com/v1。

不要因为某个客户端出现 /v1/v1,就把所有客户端都改成根域。只修正那个明确会自动追加 /v1 的字段。

常见问题

MonkeyAI 的 Base URL 要带 /v1 吗?

对于标为 Base URL、OpenAI Base URL 或 API Base 的字段,通常填写 https://monkeytheme.com/v1。只有客户端明确说明会自动追加 /v1 时才填写根域。

401 是否代表 Base URL 错了?

/v1/models 返回 JSON 401 说明 API 路由存在,下一步检查认证。/models 或 /v1/v1/models 返回 404 才是典型路径错误。

客户端自动追加 /v1 怎么处理?

以该客户端官方文档为准。只有文档明确说明自动追加时才填写 https://monkeytheme.com,不要把这个例外套用到所有客户端。

/v1/models/ 尾部斜杠有影响吗?

MonkeyAI 当前会用 HTTP 301 将 /v1/models/ 重定向到 /v1/models。建议直接使用无尾斜杠的规范路径。

相关教程

API Key 与错误码

用一个最小请求区分 401、404 和模型错误。

打开排错教程

Codex CLI

使用独立 Profile 和已验证的 Responses 路由。

打开 Codex 教程

Agent 客户端

根据实际使用的客户端选择对应配置指南。

打开 Agent 中心