TrueAPI
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/订阅登录,不应通过平台中转。