把 apimodels 接进任意 AI 客户端
我们暴露标准 OpenAI 接口(/v1/chat/completions 和 /v1/models),所以 Cherry Studio、Cursor、ChatBox、LobeChat、NextChat 等任何支持「自定义 OpenAI 服务商」的客户端,都能用一个 API key 直接接入,聊 GPT-6.1 Sol、Claude、Gemini、GLM 等全部模型——通常 1 分钟搞定。图片、视频、音频模型走各自的任务接口(见对应文档页),同一把 key 通用。
三个值,填到哪个客户端都一样
| Base URL / API 地址 | https://api.apimodels.app/v1 |
| API Key | 你的 sk_… key(控制台创建) |
| 模型 ID | gpt-5.6-sol · gpt-6.1-sol · claude-opus-5-5 · gemini-3-pro-preview · gpt-image-2 |
没有 key?到 控制台 → API Keys 一键创建一个 sk_… 字符串。
各客户端怎么填
Cursor
https://api.apimodels.app/v1Settings → Models → 打开 Override OpenAI Base URL 填上面地址,API Key 填 sk_… key,再手动添加模型名(如 gpt-6.1-sol)。
ChatBox
https://api.apimodels.app/v1设置 → 模型提供方选「OpenAI API 兼容」,API 域名填上面地址,密钥填 sk_… key,模型填 gpt-6.1-sol。
LobeChat
https://api.apimodels.app/v1设置 → 语言模型 → OpenAI,填 API Key 和 API 代理地址(上面地址),模型用 gpt-6.1-sol。
NextChat
https://apimodels.app设置 → 自定义接口,接口地址填 https://apimodels.app(它会自动补 /v1),API Key 填 sk_… key,模型 gpt-6.1-sol。
任意 OpenAI 兼容 App / SDK
https://api.apimodels.app/v1base_url 填上面地址,api_key 填 sk_… key,model 填 gpt-6.1-sol。下面是 OpenAI SDK 示例。
想在聊天窗口里直接出图?
上面这套只管对话:图片、视频、语音模型走各自的任务接口,不在 /v1/chat/completions 上,所以填完 base URL 也调不到它们。要在聊天里直接用,装我们的 MCP 服务器 —— 一条 npx 命令,Claude Desktop、Cursor、Cherry Studio 都支持,同一把 key。装好之后助手会自己写提示词、生成、看结果、再改了重出。
编码 Agent 怎么填
这类工具会读写你本地的文件、执行命令,所以必须选**支持函数调用(tools)**的模型 —— 选了不支持的,它会一直卡在读取步骤而不报错。下面每一条都标了它走哪种协议:三家用的线路不同,地址也不同,别照着聊天客户端那一栏填。
Claude Code
详细https://api.apimodels.app设三个环境变量:ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。注意 base URL 就是裸域名、不带任何路径 —— Claude Code 自己会补 /v1/messages。
Codex CLI
详细https://api.apimodels.app/v1在 ~/.codex/config.toml 里加一个 model_provider,wire_api 必须写 "responses"(不是 chat)。这两个模型只在 Responses 接口上提供。
Cline / Roo Code(VS Code)
https://api.apimodels.app/v1API Provider 选「OpenAI Compatible」,Base URL 与 API Key 填左侧,Model ID 手填。选带工具能力的模型 —— 这类插件要靠函数调用改文件,选错模型会一直卡在读取步骤。
Gemini CLI
详细https://api.apimodels.app设 GOOGLE_GEMINI_BASE_URL(裸域名,不带路径)和 GEMINI_API_KEY 两个环境变量;首次启动登录方式选「Use Gemini API key」,别选 Google 账号。
OpenClaw
详细https://api.apimodels.app/v1在 ~/.openclaw/openclaw.json 的 models.providers 里加一个自定义 provider(api 填 "openai-completions");要用的模型必须列进 models 数组,否则报 model not allowed。
Continue
https://api.apimodels.app/v1在 config.json 的 models 里加一项:provider 填 "openai",apiBase 填左侧地址,apiKey 填 sk_… key,model 填模型 ID。
Aider
https://api.apimodels.app/v1设 OPENAI_API_BASE 和 OPENAI_API_KEY 两个环境变量,再用 aider --model openai/claude-opus-5-5 启动。模型名前面的 openai/ 前缀不能省,那是 aider 用来选协议的。
代码接入(OpenAI SDK)
任何用 OpenAI SDK 的项目,只改 base_url 和 api_key 两处即可指到我们这边——不用改其它代码。
from openai import OpenAI
client = OpenAI(
base_url="https://api.apimodels.app/v1",
api_key="sk_your_key_here",
)
resp = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Reply with exactly: ok"}],
)
print(resp.choices[0].message.content)import OpenAI from "openai"
const client = new OpenAI({
baseURL: "https://api.apimodels.app/v1",
apiKey: "sk_your_key_here",
})
const resp = await client.chat.completions.create({
model: "gpt-6.1-sol",
messages: [{ role: "user", content: "Reply with exactly: ok" }],
})
console.log(resp.choices[0].message.content)30 秒自检
客户端连不上时,先用 curl 确认 key 和端点没问题(这正是客户端「检查连接」时打的 /models):
# confirm the endpoint + your key work (this is what a client hits on "check connection"):
curl -s https://api.apimodels.app/v1/models \
-H "Authorization: Bearer $APIMODELS_API_KEY" | head -c 300常见坑
| 症状 | 原因 / 修法 |
|---|---|
| 检查连接失败 / 拉不到模型 | 地址被拼成 …/api/v1/v1/…。Cherry Studio 这类要带结尾斜杠(…/api/v1/);会自动补 /v1 的(如 NextChat)只填 https://apimodels.app。 |
| HTTP 401 | key 错了或被禁用。去控制台新建一个 sk_… 重填。 |
| 模型没反应 / 400 Unknown model | 模型 ID 拼错,用横杠形式,如 gpt-6.1-sol、claude-opus-5-5。完整列表见 /v1/models。 |
| 余额不足 / 402 | 只对成功请求扣费;到控制台充值即可。 |