AI API 中转站怎么选？5 个在用或候选入口与统一接入文档

自定义 provider 放在用户级 `~/.codex/config.toml`。当前 Codex 的 `wire_api` 只支持 `responses`，因此中转必须真实提供 Responses API；只有 `/v1/chat/completions` 的服务不能直接套用这份配置。

# ~/.codex/config.toml
model = "YOUR_MODEL_ID"
model_provider = "relay"

[model_providers.relay]
name = "AI API Relay"
base_url = "https://YOUR_BASE_URL/v1"
env_key = "AI_RELAY_API_KEY"
wire_api = "responses"

把中转 Key 放入名为 `AI_RELAY_API_KEY` 的环境变量。`base_url` 是否包含 `/v1` 以服务商后台文档为准；不要把 provider 配置提交到项目级 `.codex/config.toml`，Codex 会忽略项目层的凭据重定向设置。

Claude Code 的网关方式使用 `ANTHROPIC_BASE_URL`。Bearer Token 通常放入 `ANTHROPIC_AUTH_TOKEN`；如果服务商明确要求 `x-api-key`，才使用 `ANTHROPIC_API_KEY`。只有 OpenAI-compatible 地址时，不能默认 Claude Code 也可用。

# PowerShell：仅对当前终端会话生效
$env:ANTHROPIC_BASE_URL = "https://YOUR_ANTHROPIC_BASE_URL"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_RELAY_KEY"
claude

# 如果服务商明确要求 x-api-key，再改用：
# $env:ANTHROPIC_API_KEY = "YOUR_RELAY_KEY"

先在临时终端会话中测试，确认模型映射、工具调用、长上下文和错误码后再持久化变量。不要同时设置两套认证变量，除非服务商文档明确要求。

1. 打开 `Cursor Settings → Models`，选择当前版本明确支持的供应商。
2. 填写中转 Key，并使用 `Verify` 检查认证。
3. 只有当前界面明确提供自定义 Base URL 时，才按中转后台填写；没有入口就不要强行套用。
4. 验证标准聊天模型后，再检查 Agent、工具调用和上下文是否可用。

Cursor 官方文档明确说明自带 Key 只覆盖标准聊天模型，Tab Completion 等专用功能仍使用 Cursor 内置模型。因此“Key 验证通过”不代表所有 Cursor 功能都走中转。

1. 进入设置中的“模型服务”，点击添加自定义服务商。
2. 按中转协议选择 OpenAI 或 Anthropic 类型，填写 Key 和 API 地址。
3. 使用“管理”获取模型，或手动填写后台给出的精确模型 ID。
4. 点击连通性检查，并打开服务商右上角启用开关。

Cherry Studio 通常会自行拼接 `/v1/chat/completions`，所以服务商给出完整路径时应先阅读其填写规则。不要机械地同时保留根地址和完整路径，否则容易出现重复 `/v1` 或重复 endpoint。

SDK 最容易统一：两个语言都读取 `AI_BASE_URL`、`AI_API_KEY`、`AI_MODEL`。下面先用兼容面更广的 Chat Completions 做最小探针；如果中转明确支持 Responses API，再按其文档切换。

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AI_API_KEY,
  baseURL: process.env.AI_BASE_URL,
});

const result = await client.chat.completions.create({
  model: process.env.AI_MODEL,
  messages: [{ role: "user", content: "Reply with OK" }],
});

console.log(result.choices[0]?.message?.content);

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AI_API_KEY"],
    base_url=os.environ["AI_BASE_URL"],
)

result = client.chat.completions.create(
    model=os.environ["AI_MODEL"],
    messages=[{"role": "user", "content": "Reply with OK"}],
)

print(result.choices[0].message.content)

生产代码还要补超时、指数退避、429 / 5xx 分类、request id、脱敏日志和取消处理。不要把 Key 写进浏览器前端或仓库。