AI API 中转站 · 文档
首页 / 使用文档 / 配置 Agent / 客户端

在 Agent 和客户端中配置 API：Base URL、Key、模型 ID、协议

最后更新：

不管什么 Agent / 客户端，要填的东西都差不多：接口地址（Base URL）、Key、模型 ID、显示名、协议。先看懂这 5 项，再看下面各客户端的具体填法。

5 个配置项逐个说明

① Base URL（接口地址 / API 地址 / API Host）

协议Base URL客户端实际请求的地址
OpenAI Chat Completionshttps://ai-api.site/v1/v1/chat/completions
OpenAI Responseshttps://ai-api.site/v1/v1/responses
Anthropic Messageshttps://ai-api.site/v1/messages
最常见的坑
有些客户端会自己补 /v1（比如 Cherry Studio 的「API 地址」只填 https://ai-api.site）。如果报 404，就在「带 /v1」和「不带 /v1」之间换一下试试。不要把 /chat/completions 也填进去，除非客户端明确要求填完整地址。

② API Key（密钥 / Token / Auth Token）

填在控制台复制的 sk- 开头的完整字符串。前后不要有空格；不要加 Bearer 前缀（客户端会自动加）。Key 的分组决定了能用哪些模型，见 分组怎么选。

③ 模型 ID（Model / 模型名称）

从 模型广场 复制，必须一字不差，例如 claude-opus-5-5、gpt-6-sol、deepseek-flash。很多客户端有「获取模型列表」按钮，点一下就会列出你这个 Key 能用的全部模型（本质是请求 /v1/models）。

④ 显示名（名称 / 别名 / Display Name）

随便写，只用于在客户端界面上显示，比如「Opus 5.5」「便宜的 GPT」。它不会发给服务器，写错也不影响调用。供应商名称（Provider Name）同理，可以写「AI API」。

⑤ 协议（接口类型 / Provider Type / API 格式）

协议什么时候选本站支持的模型
OpenAI（Chat Completions）不知道选什么就选它；绝大多数客户端、SDK 默认用它Claude、GPT、DeepSeek 全部支持
Anthropic（Messages）Claude Code，或客户端选「Anthropic / Claude」类型时Claude、GPT、DeepSeek 实测都可以
OpenAI ResponsesCodex CLI，或客户端提供「Responses」选项时GPT 系列
图片生成（Images）生图模型专用，不能用聊天协议gpt-image 系列，见 生图教程
推荐
一句话：Claude Code 用 Anthropic，Codex 用 Responses，其他一律 OpenAI。

Claude Code

Key 建议选 anthropic-kiro（便宜，5 系列）或 claudeMAX（全系列）分组。Claude Code 使用 Anthropic 协议，Base URL 不带 /v1。

方式 A：配置文件（推荐，所有系统通用）

编辑 ~/.claude/settings.json（Windows：C:\Users\你的用户名\.claude\settings.json），没有就新建：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai-api.site",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-sonnet-5-5"
  }
}

方式 B：环境变量

# macOS / Linux（写进 ~/.zshrc 或 ~/.bashrc 后重开终端）
export ANTHROPIC_BASE_URL="https://ai-api.site"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-sonnet-5-5"
# Windows PowerShell（永久生效，执行后重开终端）
setx ANTHROPIC_BASE_URL "https://ai-api.site"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
setx ANTHROPIC_MODEL "claude-opus-5-5"

配置好后在项目目录运行 claude，输入 /status 能看到当前 Base URL 和模型；用 /model 可以切换模型（填模型 ID）。

提示
ANTHROPIC_SMALL_FAST_MODEL 是 Claude Code 后台做小任务用的模型，填你分组里有的便宜模型即可。如果你的分组里没有 Haiku，就填一个 Sonnet，否则后台任务会报错。

也可以用首页推荐的 CC Switch 图形化切换：新增供应商时，名称随便填，请求地址填 https://ai-api.site，API Key 填你的 Key，模型填模型 ID 即可。

Codex CLI

Key 选 vip-1 分组。Codex 用 Responses 协议，Base URL 带 /v1。编辑 ~/.codex/config.toml：

# ~/.codex/config.toml   （Windows: C:\Users\你的用户名\.codex\config.toml）
model = "gpt-6-sol"
model_provider = "aiapi"

[model_providers.aiapi]
name = "AI API"
base_url = "https://ai-api.site/v1"
env_key = "AIAPI_KEY"
wire_api = "responses"

再把 Key 设置为环境变量（名字和上面 env_key 一致），然后重开终端运行 codex：

# macOS / Linux
export AIAPI_KEY="sk-你的Key"
# Windows PowerShell
setx AIAPI_KEY "sk-你的Key"

可用模型：gpt-6-sol、gpt-6.1-sol、gpt-6-astra、gpt-5.6-sol。

Cherry Studio 等聊天客户端

Cherry Studio、ChatBox、NextChat、LobeChat、沉浸式翻译等「OpenAI 兼容」客户端填法基本一样：

  1. 设置 → 模型服务 / 模型供应商 → 添加，类型选 OpenAI（或「OpenAI 兼容」）。
  2. 名称：随便写，如「AI API」。
  3. API 密钥：粘贴你的 Key。
  4. API 地址：https://ai-api.site（Cherry Studio 会自动补 /v1；其他客户端若要求完整地址就填 https://ai-api.site/v1）。
  5. 模型：点「管理 / 获取模型列表」勾选，或手动「添加模型」填模型 ID；「模型名称 / 显示名」随便写。
  6. 点「检查 / 测试连接」，选一个模型测试通过即可。
提示
在 Cherry Studio 里用 Claude 模型时，供应商类型也可以选 Anthropic，API 地址同样填 https://ai-api.site。两种都能用，选一种即可。

其他 Agent（通用填法）

Cline、Roo Code、Kilo Code、Continue、OpenCode、Dify、n8n、各类自研 Agent……只要它支持自定义接口，都按下表填：

界面上的字段填什么
API Provider / 供应商类型OpenAI Compatible（OpenAI 兼容）；如果只用 Claude 也可以选 Anthropic
Base URL / API Host / EndpointOpenAI 兼容：https://ai-api.site/v1；Anthropic：https://ai-api.site
API Keysk- 开头的 Key
Model ID模型广场里的模型 ID，例如 claude-sonnet-5-5
Display Name / Nickname随便写
Context Window / Max Tokens不确定就留默认；Claude 可填 200000，GPT 可填 272000

在代码里调用

OpenAI SDK（所有模型通用）

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://ai-api.site/v1",   # 带 /v1
    api_key="sk-你的Key",
)
resp = client.chat.completions.create(
    model="claude-opus-5-5",              # 模型广场里的模型 ID
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(resp.choices[0].message.content)

Anthropic SDK

# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    base_url="https://ai-api.site",      # 不带 /v1
    api_key="sk-你的Key",
)
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

cURL 测试

curl https://ai-api.site/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }'

查看这个 Key 能用哪些模型：

curl https://ai-api.site/v1/models -H "Authorization: Bearer sk-你的Key"

配好了怎么确认？

  1. 客户端里发一句「你好」，能正常回复就成功了。
  2. 到「控制台 → 使用日志」能看到这条请求和扣费，说明走的是本站。
  3. 报错就看 常见问题，大部分是 Base URL、模型 ID 或分组填错。

下一步：图片生成怎么传参数 →