APIMODELSAPIMODELS
OpenAI 兼容 · 一个 key 全模型

把 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(控制台创建)
模型 IDgpt-5.6-sol · gpt-6.1-sol · claude-opus-5-5 · gemini-3-pro-preview · gpt-image-2

没有 key?到 控制台 → API Keys 一键创建一个 sk_… 字符串。

各客户端怎么填

Cherry Studio

详细
API 地址
https://api.apimodels.app/v1/

设置 → 模型服务 → 添加,类型选 OpenAI。地址结尾要带斜杠。

Cursor

API 地址
https://api.apimodels.app/v1

Settings → Models → 打开 Override OpenAI Base URL 填上面地址,API Key 填 sk_… key,再手动添加模型名(如 gpt-6.1-sol)。

ChatBox

API 地址
https://api.apimodels.app/v1

设置 → 模型提供方选「OpenAI API 兼容」,API 域名填上面地址,密钥填 sk_… key,模型填 gpt-6.1-sol。

LobeChat

API 地址
https://api.apimodels.app/v1

设置 → 语言模型 → OpenAI,填 API Key 和 API 代理地址(上面地址),模型用 gpt-6.1-sol。

NextChat

API 地址
https://apimodels.app

设置 → 自定义接口,接口地址填 https://apimodels.app(它会自动补 /v1),API Key 填 sk_… key,模型 gpt-6.1-sol。

任意 OpenAI 兼容 App / SDK

API 地址
https://api.apimodels.app/v1

base_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。装好之后助手会自己写提示词、生成、看结果、再改了重出。

MCP 服务器接入指南 →

编码 Agent 怎么填

这类工具会读写你本地的文件、执行命令,所以必须选**支持函数调用(tools)**的模型 —— 选了不支持的,它会一直卡在读取步骤而不报错。下面每一条都标了它走哪种协议:三家用的线路不同,地址也不同,别照着聊天客户端那一栏填。

Claude Code

详细
Anthropic Messagesclaude-opus-5-5
API 地址
https://api.apimodels.app

设三个环境变量:ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。注意 base URL 就是裸域名、不带任何路径 —— Claude Code 自己会补 /v1/messages。

Codex CLI

详细
OpenAI Responsesgpt-5.4 / gpt-5.5
API 地址
https://api.apimodels.app/v1

在 ~/.codex/config.toml 里加一个 model_provider,wire_api 必须写 "responses"(不是 chat)。这两个模型只在 Responses 接口上提供。

Cline / Roo Code(VS Code)

OpenAI 兼容claude-opus-5-5
API 地址
https://api.apimodels.app/v1

API Provider 选「OpenAI Compatible」,Base URL 与 API Key 填左侧,Model ID 手填。选带工具能力的模型 —— 这类插件要靠函数调用改文件,选错模型会一直卡在读取步骤。

Gemini CLI

详细
Gemini 原生(v1beta)gemini-3-flash-preview
API 地址
https://api.apimodels.app

设 GOOGLE_GEMINI_BASE_URL(裸域名,不带路径)和 GEMINI_API_KEY 两个环境变量;首次启动登录方式选「Use Gemini API key」,别选 Google 账号。

OpenClaw

详细
OpenAI 兼容claude-opus-5-5
API 地址
https://api.apimodels.app/v1

在 ~/.openclaw/openclaw.json 的 models.providers 里加一个自定义 provider(api 填 "openai-completions");要用的模型必须列进 models 数组,否则报 model not allowed。

Continue

OpenAI 兼容claude-opus-5-5
API 地址
https://api.apimodels.app/v1

在 config.json 的 models 里加一项:provider 填 "openai",apiBase 填左侧地址,apiKey 填 sk_… key,model 填模型 ID。

Aider

OpenAI 兼容claude-opus-5-5
API 地址
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 两处即可指到我们这边——不用改其它代码。

Python
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)
Node.js
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 401key 错了或被禁用。去控制台新建一个 sk_… 重填。
模型没反应 / 400 Unknown model模型 ID 拼错,用横杠形式,如 gpt-6.1-sol、claude-opus-5-5。完整列表见 /v1/models。
余额不足 / 402只对成功请求扣费;到控制台充值即可。