文本模型接入指南

先选协议,再复制对应客户端的完整配置。

新手不需要理解所有 API。先选择 AIReiter 当前代码已支持的 Responses、Messages 或 Chat,再复制官方或代码可验证的配置。

价格对比GPT-5.6 模型按官方 API 价格的 50% 定价

官方 API 价格 vs AIReiter 价格

所有价格均为每 100 万 tokens。AIReiter 当前按 GPT-5.6 官方价格的一半展示,包含普通输入、输出、缓存读和缓存创建。

50%

两档上下文、四类计费项都按官方 API 价格的一半计算。

模型上下文档位输入输出缓存读缓存创建
GPT-5.6 Luna上下文 < 272K
官方$1.00AIReiter$0.50
官方$6.00AIReiter$3.00
官方$0.10AIReiter$0.05
官方$1.25AIReiter$0.625
GPT-5.6 Luna上下文 >= 272K
官方$2.00AIReiter$1.00
官方$9.00AIReiter$4.50
官方$0.20AIReiter$0.10
官方$2.50AIReiter$1.25
GPT-5.6 Terra上下文 < 272K
官方$2.50AIReiter$1.25
官方$15.00AIReiter$7.50
官方$0.25AIReiter$0.125
官方$3.125AIReiter$1.5625
GPT-5.6 Terra上下文 >= 272K
官方$5.00AIReiter$2.50
官方$22.50AIReiter$11.25
官方$0.50AIReiter$0.25
官方$6.25AIReiter$3.125
GPT-5.6 Sol上下文 < 272K
官方$5.00AIReiter$2.50
官方$30.00AIReiter$15.00
官方$0.50AIReiter$0.25
官方$6.25AIReiter$3.125
GPT-5.6 Sol上下文 >= 272K
官方$10.00AIReiter$5.00
官方$45.00AIReiter$22.50
官方$1.00AIReiter$0.50
官方$12.50AIReiter$6.25

计费如何对齐上游

档位按完整输入上下文长度判断。上游返回 cached_tokens 或 cache_write_tokens 时,分别走缓存读或缓存创建价格;没有缓存命中时,就走普通输入和输出价格。

Responses 协议/api/v1/responses

Codex CLI

Codex CLI 这类工具最适合走 Responses。核心是 base_url 写到 /api/v1,wire_api 写 responses,Key 走 env_key 指向的环境变量。

OpenAI 官方查看来源

model_providers / base_url / wire_api / env_key 字段来自 Codex 官方 Advanced Configuration 文档;env_key 必须指向环境变量、requires_openai_auth 会禁用 env_key 也来自官方说明。注意 Codex 0.59 起 wire_api 仅支持 responses。

客户端 Base URL

https://aireiter.com/api/v1

客户端追加路径

/responses

最终请求 URL

https://aireiter.com/api/v1/responses

示例模型

gpt-5.6-luna

1

1. 写 config.toml

文件位置 ~/.codex/config.toml。base_url 必须停在 /api/v1,Codex 会按 wire_api = "responses" 调 /responses。env_key 指向环境变量名,不要在 TOML 里写真实 Key;也不要加 requires_openai_auth = true——加了 Codex 会忽略 env_key、转而要求 OpenAI 官方登录。

可直接复制
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
2

2. 导出 API Key 环境变量

Codex 启动时从 env_key 指定的环境变量读 Key。写入 shell 配置文件永久生效;不要把真实 Key 提交到代码仓库。

可直接复制
echo 'export AIREITER_API_KEY="sk-替换成你的Key"' >> ~/.zshrc
source ~/.zshrc
3

3. macOS / Linux 一键生成

两步合成一段,直接复制执行。已有 config.toml 的用户请手动合并,避免覆盖其他 provider。

可直接复制
mkdir -p "$HOME/.codex"

cat > "$HOME/.codex/config.toml" <<EOF
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
EOF

echo 'export AIREITER_API_KEY="sk-替换成你的Key"' >> ~/.zshrc
source ~/.zshrc
4

4. Windows PowerShell 一键生成

Windows 用户复制这一段。环境变量用 setx 写入用户级,写完后需要重开一个终端窗口才生效。

可直接复制
$configDir = "$env:USERPROFILE\.codex"
New-Item -Path $configDir -ItemType Directory -Force | Out-Null

@"
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
"@ | Set-Content -Path "$configDir\config.toml"

setx AIREITER_API_KEY "sk-替换成你的Key"
5

5. 联通性自检

先请求模型列表。能返回 JSON 列表再启动 Codex,排障会轻很多。

可直接复制
curl -sS -i "https://aireiter.com/api/v1/models" \
  -H "Authorization: Bearer $AIREITER_API_KEY" | head -n 20
6

6. 启动 Codex

进入项目目录后启动。若能流式输出,说明 Responses 接入跑通。

可直接复制
cd ~/your-project
codex
7

状态码对照

用户报错时,先看状态码,再看 base_url 和 Key。

可直接复制
HTTP 200  配置正确,可以启动客户端
HTTP 401  Key 错误或没带上,重新复制 API Key
HTTP 403  Key 没有该模型权限,检查账户或模型权限
HTTP 404  URL 写错,优先检查 base_url 是否多写/少写 /api/v1
返回 HTML  请求打到了网站前端,说明 base_url 写错
HTTP 502/504  网关或上游抖动,稍后重试
第三方客户端速查配置字段均来自各客户端官方文档

CC Switch、OpenClaw 怎么选 endpoint?

它们本身不是协议,而是承接协议的客户端:给 Claude Code 系工具配 Anthropic 风格地址、给 OpenAI-compatible 工具配 /api/v1。完整分步教程见上面对应协议下的接入方式。

CC Switch

Claude Code 页签的供应商请求地址填 https://aireiter.com/api,教程在「Messages 协议 → CC Switch 图形化」;Codex 页签填 https://aireiter.com/api/v1,教程在「Responses 协议 → CC Switch 图形化」。

OpenClaw

api: "openai-completions" 时 baseUrl 填 https://aireiter.com/api/v1;api: "anthropic-messages" 时填 https://aireiter.com/api。分步教程在「Chat 协议 → OpenClaw」。

竞品对齐OpenAI-compatible 的 baseURL 写法

不要把 Base URL 和最终 URL 混在一起。

OpenRouter、Groq、Together 这类文本模型网关的文档,都是让 SDK 的 baseURL/base_url 停在 /v1,由 SDK 方法追加 /chat/completions。所以本页也按这个方式拆开:客户端 Base URL、客户端追加路径、最终请求 URL 分开显示。

有 count_tokens 吗?

有,路径是 /api/v1/messages/count_tokens。它只做 Anthropic token 计数,不是生成接口。

来源可靠吗?

可复制配置只保留官方文档、OpenAI/Anthropic 协议或本项目代码能验证的内容;第三方客户端只做兼容说明。

新手怎么选?

Codex 选 Responses;Claude Code 选 Messages;OpenAI SDK 和普通 OpenAI-compatible 客户端选 Chat;不想改配置文件就用 CC Switch 图形化接入。