首页 / 文档 / OpenAI 兼容接口覆盖

MonkeyAI 实际开放哪些 /v1 路由？

在配置 OpenAI、Anthropic 或 Gemini 风格 SDK 前，判断一条路径是否被支持的唯一可信做法是发一次探测并读状态码。本页把 2026-08-09 在公网上的逐条探测结果整理成端点矩阵。

创建账号OpenAI 兼容网关总览客户端配置矩阵
2026-08-09探测时间
22 条HTTP method × /v1/* 组合
7 条已支持返回 401（先鉴权）
13 条未开放返回 404 page not found

本次实测做了什么

下面每一行都来自同一时刻的 curl 探测。所有行都使用同一组无效 Bearer Key，所以已支持的路由返回 401（约 0.6–0.9 秒），未支持的路由立即返回 nginx 404。探测不调用任何上游供应商，也不消耗客户额度。

先单独说一条值得提前注意的行：POST /v1/images/generations 返回 401 INVALID_API_KEY。这说明中转层认这条路由，先做鉴权；只有带上真实 Key 后才会进入图片模型账号池判断。

端点矩阵（2026-08-09）

Method路径状态含义
GET/v1/models401已支持。鉴权探针，路由存在，先校验 API Key。
POST/v1/chat/completions401已支持。OpenAI Chat Completions，先鉴权后路由。
POST/v1/responses401已支持。OpenAI Responses 端点。
POST/v1/messages401已支持。Anthropic Messages，先鉴权后路由。
POST/v1/embeddings401已支持。Embeddings 中转路径，详见 Embeddings 文档。
POST/v1/images/generations401已支持。鉴权通过后再判断图片模型账号池。
POST/v1/audio/speech404未开放。当前 sub2api 路由表中没有这条。
POST/v1/moderations404未开放。本机无 moderation 中转路径。
POST/v1/audio/transcriptions404未开放。无音频输入中转路径。
GET/v1/files404未开放。MonkeyAI 没有文件存储接口。
GET/v1/fine_tuning404未开放。无 fine-tuning jobs 接口。
GET/v1/fine_tuning/jobs404未开放。同上。
GET/v1/batches404未开放。使用内联请求，不要用 batch 任务。
GET/v1/assistants404未开放。本中转层无 assistant 运行时。
GET/v1/chat404路径错误，请用 /v1/chat/completions。
GET/v1/completions404已废弃的 Completions 未开放。
GET/v1/images404路径错误，请用 /v1/images/generations。
GET/v1/audio404路径错误，且 audio 路由目前未开放。
DELETE/v1/models404方法错误，/v1/models 只支持 GET。
PUT/v1/models404方法错误。
GET/v1/chat/completions404方法错误，Chat Completions 必须用 POST。
OPTIONS/v1/chat/completions403Cloudflare 拒绝预检，请用真实 POST。

鉴权头矩阵（2026-08-09）

三种鉴权头都被接受。探测中所有行使用同一无效 Key，所以 401 INVALID_API_KEY 证明鉴权头通过、Key 失败。

GET /v1/models 携带的请求头状态响应 code
无鉴权头401API_KEY_REQUIRED
Authorization: Bearer ***401INVALID_API_KEY
x-api-key: ***401INVALID_API_KEY
x-goog-api-key: ***401INVALID_API_KEY
Bearer + x-api-key + x-goog-api-key401INVALID_API_KEY
anthropic-version: 2023-06-01（无鉴权头）401API_KEY_REQUIRED
anthropic-version 请求头会被原样转发，但不会用于鉴权。不带上面三种鉴权头中的任意一种，仍然返回 401 API_KEY_REQUIRED。

如何使用本矩阵

  1. 如果路由在上表 401 行列，说明中转层认这条路径。剩余可能失败的是：API Key（401）、模型 id（来自供应商的 404）、上游限流（429/502）、上游超时（504）。修改客户端前请先看对应的排错文档。
  2. 如果路由在上表 404 行列，说明中转层根本没实现这条路径。请改用最接近的已支持路径，不要自己拼新路径。
  3. 如果客户端返回的状态码在本表里查不到，请先记录状态码、请求路径、响应体和 request id，然后查阅对应排错文档：401、429、503、504、model not found。

本矩阵不能回答的问题

接口覆盖会随 sub2api 上游版本变化。如果客户端上某条路径突然 404，请先用同一脚本重新探测，再去改客户端代码。

常见问题

MonkeyAI 是否开放 /v1/audio/speech 或 /v1/moderations？

未开放。两条路径在 2026-08-09 实测中都返回 404 page not found，当前 sub2api 路由表中没有这两条。

为什么 POST /v1/images/generations 返回 401 而不是 404？

图片路由存在，中转层先做 API Key 校验。无效 Key 时返回 401 INVALID_API_KEY，不会触发供应商路由。

是否提供 /v1/files、/v1/fine_tuning、/v1/batches、/v1/assistants？

全部不提供，四条都返回 404 page not found。MonkeyAI 只中转 chat、responses、messages、embeddings、images。

MonkeyAI 是否接受 Anthropic SDK 风格的 x-api-key 请求头？

接受。仅带 x-api-key 访问 /v1/models 返回 401 INVALID_API_KEY；同时带三种鉴权头也是同样的结果。

anthropic-version 会被当作鉴权头吗？

不会。只带 anthropic-version: 2023-06-01 返回 401 API_KEY_REQUIRED。该请求头会被转发，但不参与鉴权。

相关教程

OpenAI 兼容网关总览

中转层的定位、接受的鉴权头，以及首次 401 / 404 的读取方式。

打开教程

Embeddings 接口配置

/v1/embeddings 路由详解，含 401/404 探测与模型 id 校验。

打开教程

客户端配置矩阵

把每个支持的客户端对应到正确的 Base URL、请求头和探测顺序。

打开教程