接入协议

接入协议

不同客户端要求的请求格式并不相同。选协议时要同时核对 Base URL、请求路径、鉴权头和 Key 分组；协议只决定入站格式，并不会自动增加账户没有的模型权限。

一眼对号入座

API Key 通常以 Bearer 方式发送：Authorization: Bearer <API_KEY>。Gemini 原生客户端可按对应 SDK 的鉴权设置传递同一 Key；不要把密钥拼进 URL 查询参数。

Anthropic 协议接入

Anthropic SDK 的 Base URL 填 https://mrxapi.com，不要预先加 /v1，因为 SDK 会自行构造资源路径。手写 HTTP 请求则应填写完整路径：

复制curl "https://mrxapi.com/v1/messages" \
  -H "Authorization: Bearer $MRXAPI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID","max_tokens":128,"messages":[{"role":"user","content":"只回复 OK"}]}'

将 MODEL_ID 替换为模型广场显示的 ID。Claude Code 等客户端的环境变量名可能不同，按各自工具页配置，不要将 OpenAI 的 /v1 Base URL 复制过去。

OpenAI 协议接入

OpenAI SDK 的 Base URL 通常填 https://mrxapi.com/v1。常见端点由客户端选择：

复制curl "https://mrxapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $MRXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"只回复 OK"}]}'

如果 SDK 会自动附加 /chat/completions，配置项只写 Base URL，不要把完整端点再填进 Base URL。

Gemini 原生协议接入

Base URL 使用 https://mrxapi.com，请求中带 /v1beta：

复制curl "https://mrxapi.com/v1beta/models" \
  -H "Authorization: Bearer $MRXAPI_KEY"

调用模型时将模型 ID 放在路径中：

复制POST https://mrxapi.com/v1beta/models/MODEL_ID:generateContent
POST https://mrxapi.com/v1beta/models/MODEL_ID:streamGenerateContent

图片生成示例和图片字段见Gemini 生图 API。不要把此路径改写成 /chat/completions。

协议和可用模型是两件事

同一个模型是否可调，取决于模型广场、Key 分组以及站点当前路由配置。若 /models 中没有某个模型，切换成另一种协议不会绕过权限。配置前复制控制台当前显示的模型 ID；模型列表返回空或请求被拒时，检查 Key 状态和分组。

排错速查

下一步

按客户端选择左侧“工具配置”，或继续阅读常见问题。