灵眸文档
用户指南

接入协议

灵眸只支持两种接入协议——Anthropic 协议（不带 /v1）与 OpenAI 协议（带 /v1）。一张表选对 Base URL，避免 401 / 404 报错。

灵眸只有两种接入协议，按工具客户端协议对号入座即可。两套端点共用同一个 API Key（同一份余额扣费）。

先理清两件事

  • 「用哪种协议」：由客户端 / SDK 决定。Anthropic SDK 走 /v1/messages，OpenAI SDK 走 /v1/chat/completions、/v1/responses。
  • 「能调哪些模型」：由你的 API Key 所属分组（即你的订阅 / 充值套餐对应的上游账号）决定，和你选哪种协议是两件独立的事。

也就是说：选错协议会直接 401 / 404；选对协议但模型不在你分组的可用范围内，会返回模型不可用类的错误。

最常见的报错来自填错协议

  • Anthropic 协议 的 Base URL 不带 /v1 后缀
  • OpenAI 协议 的 Base URL 必须带 /v1 后缀

填错会直接导致 401 / 404，把这一页存为书签，配置任何工具前先来这里对一眼。

一眼对号入座

协议Base URL典型工具
Anthropic 协议https://api.lmuai.comClaude Code（CLI / 桌面版 / VS Code 插件）、官方 anthropic SDK、Cherry Studio、Kilo Code 接 Claude / 国产模型、所有兼容 Anthropic 协议的客户端
OpenAI 协议https://api.lmuai.com/v1Codex CLI、Codex App、Cursor / Cline / Roo Code / OpenCode、官方 openai SDK、VS Code 插件接 GPT、Kilo Code 接 OpenAI 模型、所有兼容 OpenAI 协议的客户端

鉴权两套协议都用同一个 sk- 开头的密钥：

  • Anthropic 协议：Authorization: Bearer <YOUR_API_KEY> 或 x-api-key: <YOUR_API_KEY>
  • OpenAI 协议：Authorization: Bearer <YOUR_API_KEY>

Anthropic 协议接入

Base URL： https://api.lmuai.com（不带 /v1）

端点：

  • POST /v1/messages — 消息对话
  • POST /v1/messages/count_tokens — token 计数
  • GET /v1/models — 可用模型列表

Python SDK 示例：

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.lmuai.com",
    api_key="sk-xxxxxxxx",
)

resp = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.content[0].text)

curl 示例：

curl -X POST https://api.lmuai.com/v1/messages \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"你好"}]
  }'

为什么 SDK 配的是不带 /v1，curl 又带 /v1？

Anthropic 官方 SDK 的 base_url 习惯就是不带 /v1，SDK 内部会自动拼接 /v1/messages 等路径。而你手写 curl 时则要写完整路径 /v1/messages。两种写法对应同一个端点。

OpenAI 协议接入

Base URL： https://api.lmuai.com/v1（带 /v1）

端点：

  • POST /chat/completions — 标准 Chat Completions API
  • POST /responses — OpenAI Responses API（含 /responses/{id} 子路径）
  • POST /images/generations、POST /images/edits — 图片生成 / 编辑

Python SDK 示例：

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmuai.com/v1",
    api_key="sk-xxxxxxxx",
)

resp = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

curl 示例：

curl -X POST https://api.lmuai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role":"user","content":"你好"}]
  }'

协议和可用模型是两件事

你的 Key 能调哪些模型，完全由所属分组挂载的上游账号决定，和你用哪种协议调用无关：

你的分组挂的上游实际能调的模型
仅 OpenAI 账号仅 GPT 系列
仅 Claude 账号仅 Claude 系列（即便你用 OpenAI 协议调用，后端会做协议转换，但模型范围不变）
仅国产模型上游（如 GLM / Kimi 等）仅对应的国产模型
后台配置了模型路由（多上游分组）按模型名分流到不同上游，可跨品牌——具体范围以分组配置为准

所以：

  • 选「Anthropic 协议」不等于「只能调 Claude」，选「OpenAI 协议」也不等于「只能调 GPT」——协议是入站格式，模型范围由分组决定。
  • 想知道当前 Key 实际能调哪些模型，去后台「API 密钥」详情或「可用模型」页面查看分组对应的模型清单。

关于 Claude Max 分组

Claude Max 分组仅支持 Anthropic 协议

Claude Max 分组只供 Claude Code 使用，所以它只能走 Anthropic 协议（https://api.lmuai.com）。

如果你用的是 Claude Max 套餐分组下的密钥：

  • ✅ 可以在 Claude Code（CLI / 桌面版 / VS Code 插件）中使用
  • ❌ 不能用在 Codex CLI、Cursor、Cherry Studio 等任何走 OpenAI 协议的工具上
  • ❌ 不能填入 https://api.lmuai.com/v1

需要在 OpenAI 协议工具中使用，请改用按量充值 / 普通订阅分组的密钥（具体可用模型仍以你购买的套餐分组为准）。

排错速查

现象通常原因处理
401 UnauthorizedBase URL 填错协议 / 密钥写错 / IDE 没重启核对 Base URL 是否与工具协议匹配；重启 IDE 重新加载配置
404 Not FoundOpenAI 协议地址漏写 /v1，或 Anthropic 协议地址多写了 /v1按上表重新填 Base URL
模型不可用 / No available accounts调用了不在你分组可用范围内的模型（如用 Claude Max 分组调 GPT）在后台「可用模型」页确认你分组实际包含的模型，或切换到包含目标模型的分组
429 Too Many Requests当日额度用完参考 常见问题

更多排错请参见 常见问题。

下一步

确认好协议和 Base URL 后，挑选你要用的工具：

快速开始

三步上手灵眸 AI API：注册账号、订阅套餐或充值、创建 API 密钥，然后接入 Claude Code、Codex CLI、Cursor 等工具。

模型广场

灵眸 API 全部可用模型清单（国产大模型 / Claude / OpenAI 系列），点击模型名一键复制，方便配置工具时直接粘贴使用。

On this page

一眼对号入座Anthropic 协议接入OpenAI 协议接入协议和可用模型是两件事关于 Claude Max 分组排错速查下一步