How It Works
一个平台 Key,两条正式协议面。
TrueAPI 首批正式售卖只开放 OpenAI-compatible 与 Anthropic-compatible 路由。用户只需要配置平台 Key 和 Base URL,额度、账单、路由与熔断都由平台负责;Gemini 暂时只保留后续开放说明。
支持原则
只承诺支持可自定义 API Key / Base URL 的工具。若工具必须依赖官方 OAuth 或官方订阅登录,则标记为不支持中转接入。
隐私原则
默认不存 prompt / response 正文,仅保留请求 ID、模型、token、耗时、状态码、Provider 和费用。
Available Models
OpenAI
gpt-5.3-codex
OpenAI-compatible Codex smoke and production route.
OpenAI
gpt-5.4
OpenAI-compatible high reasoning smoke and production route.
Anthropic
claude-haiku-4-5-20251001
Anthropic-compatible smoke and production route.
Codex / OpenAI-compatible
OPENAI_API_KEY=YOUR_TRUEAPI_KEY OPENAI_BASE_URL=https://api.trueapi.solocore.cn/v1 OPENAI_MODEL=gpt-5.3-codex
OpenAI-compatible 接口不再要求记内部 alias。直接按真实模型名调用,平台按模型分别计价;`/v1/responses` 未显式传 `store` 时默认注入 `store: false`。
export OPENAI_API_KEY="YOUR_TRUEAPI_KEY" export OPENAI_BASE_URL="https://api.trueapi.solocore.cn/v1" codex --provider openai --model gpt-5.3-codex # 更高推理档位 codex --provider openai --model gpt-5.4
Claude Code / Anthropic-compatible
ANTHROPIC_API_KEY=YOUR_TRUEAPI_KEY ANTHROPIC_BASE_URL=https://api.trueapi.solocore.cn/anthropic ANTHROPIC_MODEL=claude-haiku-4-5-20251001
Anthropic-compatible 侧同样直接使用真实模型名。仅适用于支持 API key / custom base URL 的模式;若某版本只支持官方 OAuth,不应宣称兼容。
Gemini
Gemini 不在首批可卖链路中,文档与正式套餐暂不承诺开放时间;后续开放时会沿用同一控制台与网关体系。
CCSwitch
ccswitch add trueapi-relay \
--api-key "YOUR_TRUEAPI_KEY" \
--base-url "https://trueapi.solocore.cn/anthropic" \
--model "claude-haiku-4-5-20251001" \
--description "TrueAPI relay via Anthropic-compatible endpoint"
# or edit ~/.ccswitch/ccs.json
{
"profiles": {
"trueapi-relay": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_TRUEAPI_KEY",
"ANTHROPIC_BASE_URL": "https://trueapi.solocore.cn/anthropic",
"ANTHROPIC_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"
}
}
}`ccswitch` 核心是给 Claude Code 写入 `ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_MODEL`。因此 TrueAPI 至少要稳定提供一个 Anthropic-compatible 入口,方便用户一键切换。
Tool Matrix
| 工具 | 模式 | 说明 |
|---|---|---|
| Codex CLI | 支持 | 使用 OpenAI-compatible Key、Base URL 与 `gpt-5.3-codex` / `gpt-5.4`。 |
| Cline / Roo | 支持 | 优先使用 OpenAI-compatible 模式接入。 |
| Claude Code / ccswitch | 支持 | 走 Anthropic-compatible 模式,推荐固定为 `claude-haiku-4-5-20251001`。 |
| Claude Code OAuth-only 模式 | 不支持 | 如果工具强依赖官方 OAuth/订阅登录,不应通过平台中转。 |