Windows / macOS 环境安装
如果你只使用网页控制台或普通聊天客户端，通常不需要安装开发环境。若要使用 CC-Switch、Codex++、命令行工具或本地开发调用，建议先准备下面这些基础环境。
| 工具 | 用途 | Windows 官网 | macOS 官网 |
|---|---|---|---|
| Node.js | 运行前端工具、部分 CLI、npm 包和插件。 | nodejs.org/en/download | nodejs.org/en/download |
| Git | 下载项目、更新插件、执行安装脚本。 | git-scm.com/downloads | git-scm.com/downloads |
| Python | 运行部分辅助脚本、插件安装器或本地工具。 | python.org/downloads | python.org/downloads |
| VS Code | 编辑配置文件、查看项目、安装开发插件。 | code.visualstudio.com/Download | code.visualstudio.com/Download |
| Homebrew | macOS 上安装和管理命令行工具。 | 不需要 | brew.sh |
Windows 安装顺序
- 安装 Git，安装时保持默认选项即可。
- 安装 Node.js，建议选择 LTS 版本。
- 按需安装 Python 和 VS Code。
macOS 安装顺序
- 打开系统自带“终端”App。
- 安装 Homebrew，用于管理命令行工具。
- 通过官网或 Homebrew 安装 Git、Node.js、Python。
- 按需安装 VS Code，用来编辑配置文件。
检查环境是否安装成功
安装完成后，打开终端分别执行下面命令。能看到版本号就说明环境可用。
node -v
npm -v
git --version
python --version请尽量从上表官网下载安装包，不要使用来历不明的网盘、论坛或第三方镜像。安装环境只用于本地工具运行，不需要填写 AnyModel 的 API Key。
注册与充值
首次使用建议先完成账号注册、登录控制台和充值确认。确认余额到账后，再继续创建 API Key。
充值方式、到账时间、余额显示和可用模型以站内控制台为准。若充值后长时间未到账，请联系 QQ：81015982 并提供账号信息和支付记录。
创建令牌
令牌就是调用 API 时使用的 API Key。建议为不同客户端或项目分别创建令牌，方便后续单独停用和排查。
如果令牌无法使用，请检查是否复制完整、账号余额是否正常、模型名称是否可用。仍无法解决时请联系 QQ：81015982 并提供报错截图。
API 调用说明
AnyModel AI 中转站采用 OpenAI 兼容接口。大多数支持自定义 OpenAI Base URL 的工具，都可以通过下面的配置接入。
https://ai.anymodel.cc/v1
Authorization: Bearer YOUR_API_KEY
POST /v1/chat/completions
以控制台可用模型为准
请求要点
- 不要把 Base URL 写成首页地址，API 调用需要带 /v1。
- API Key 前面需要带 Bearer ，注意中间有一个空格。
- 模型名称需要填写控制台中可用的模型 ID，例如客户端模型下拉框里的完整名称。
- 如果客户端有“OpenAI Compatible”“自定义 OpenAI 接口”选项，优先选择这一类配置。
常用客户端配置
不同客户端字段名称略有差异，但本质都是填写同一组信息：API Key、Base URL、模型名称。
| 客户端 | 服务类型 | Base URL | API Key | 备注 |
|---|---|---|---|---|
| Cherry Studio | OpenAI / OpenAI Compatible | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 添加模型时使用控制台中的模型 ID。 |
| Chatbox | OpenAI API | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 如果测试失败，先检查 Base URL 是否包含 /v1。 |
| Open WebUI | OpenAI API Connections | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 保存后刷新模型列表，选择可用模型开始对话。 |
| LobeChat | OpenAI 兼容供应商 | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 自定义模型名称时保持与控制台一致。 |
| CC-Switch | OpenAI Compatible / OpenAI 兼容 | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 新增供应商时名称可填 AnyModel，模型名称以控制台可用模型为准。 |
| Codex++ | OpenAI Compatible / 自定义 OpenAI 接口 | https://ai.anymodel.cc/v1 |
填写控制台创建的令牌 | 选择自定义 OpenAI 兼容接口；若通过 CC-Switch 调用，则在 Codex++ 中选择对应供应商和模型。 |
客户端通用填法
- 接口类型：OpenAI 或 OpenAI Compatible。
- API 地址：https://ai.anymodel.cc/v1。
- 密钥：控制台创建的 API Key。
- 模型：选择或手动输入控制台可用模型。
测试建议
- 先用短问题测试，例如“你好”。
- 确认客户端没有多填或漏填 /v1。
- 如果支持流式输出，优先开启以获得更快响应体验。
开发示例
下面示例中的 YOUR_API_KEY 替换为你在控制台创建的令牌，模型名替换为控制台可用模型。
curl https://ai.anymodel.cc/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{
"role": "user",
"content": "你好，请用一句话介绍 AnyModel。"
}
],
"stream": false
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://ai.anymodel.cc/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "你好，请用一句话介绍 AnyModel。"}
],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://ai.anymodel.cc/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "你好，请用一句话介绍 AnyModel。" },
],
});
console.log(response.choices[0].message.content);常见问题
401 Unauthorized
通常是 API Key 错误、令牌被删除、请求头没有写 Bearer，或复制时多了空格。重新创建令牌后再测试。
模型不存在
检查模型名称是否与控制台完全一致。客户端手动填写模型时，不要使用页面展示名代替模型 ID。
额度或余额不足
进入控制台查看账号状态。具体可用额度、模型限制和调用状态以站内显示为准。
请求超时
尝试更换模型、缩短输入内容，或稍后重试。客户端中也可以适当调高请求超时时间。
流式输出异常
先关闭客户端的流式输出测试一次。如果关闭后正常，说明客户端或网络对流式响应支持不稳定。
Base URL 填错
API Base URL 应为 https://ai.anymodel.cc/v1。不要只填首页地址，也不要重复写成 /v1/v1。
安全提醒
API Key 等同于你的调用凭证，请像密码一样保管。
不要公开密钥
- 不要把 API Key 发到群聊、论坛或截图里。
- 不要把 API Key 写进前端网页代码。
- 不要把 API Key 提交到 GitHub 等公开仓库。
建议独立管理
- 为不同软件或项目创建不同令牌。
- 怀疑泄露时立即删除旧令牌并重建。
- 长期不用的令牌建议及时清理。
遇到无法解决的问题，请联系 QQ：81015982，并说明使用的客户端、报错内容、Base URL 填写方式和模型名称。