文字模型整合指南

先選擇一種協議,然後複製適用於你的客戶端的完整設定。

你不需要理解每一個 API。先選擇 AIReiter 目前支援的 Responses、Messages 或 Chat 協議,然後複製已依官方文件或此專案程式碼驗證過的設定。

價格比較GPT-5.6 模型的定價為官方 API 費率的 50%

官方 API 價格 vs AIReiter 價格

所有價格皆以每 1M tokens 計算。AIReiter 目前設為官方 GPT-5.6 費率的一半,包括一般輸入、輸出、快取輸入以及快取寫入。

50%

AIReiter 的價格在兩個上下文層級與所有快取計費區間中,皆為官方 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 時,快取 token 會使用快取讀取或快取寫入價格;否則則適用一般輸入與輸出價格。

Responses 協議/api/v1/responses

Codex CLI

像 Codex CLI 這類工具最適合使用 Responses。重點是:base_url 停在 /api/v1,wire_api 設為 responses,並且從 env_key 指向的環境變數讀取金鑰。

OpenAI 官方檢視來源

model_providers / base_url / wire_api / env_key 欄位來自 Codex 官方 Advanced Configuration 文件;其中 env_key 必須指向一個 env 變數,而 requires_openai_auth disables env_key 也是官方說明。請注意,wire_api 自 Codex 0.59 起只接受 responses。

Client 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,也不要加入 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 金鑰環境變數

Codex 在啟動時會從由 env_key 指定名稱的 env var 讀取金鑰。請將它寫入你的 shell 設定檔以便持久保存;切勿將真實金鑰提交到 repository。

可直接複製
echo 'export AIREITER_API_KEY="sk-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
3

3. macOS / Linux 一次性設定

將兩個步驟合併成一個區塊,你可以直接貼上並執行。如果你已經有 config.toml,請手動合併以避免覆寫其他提供者。

可直接複製
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-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
4

4. Windows PowerShell 一次性設定

Windows 使用者請複製這個區塊。setx 會寫入使用者層級的 env var;請開啟新的終端機視窗使其生效。

可直接複製
$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-replace-with-your-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 和金鑰。

可直接複製
HTTP 200  設定正確,開始你的客戶端
HTTP 401  金鑰錯誤或遺失,請重新複製你的 API 金鑰
HTTP 403  金鑰無法存取此模型,請檢查帳號或模型權限
HTTP 404  URL 錯誤,先檢查 base_url 是否多了或少了 /api/v1
回傳 HTML  請求打到了網站前端,base_url 錯誤
HTTP 502/504  Gateway 或上游暫時異常,稍後再試
第三方用戶端快速參考所有設定欄位皆來自各用戶端的官方文件

CC Switch 或 OpenClaw 應使用哪個端點?

它們是承載協議的用戶端,而不是協議本身:讓 Claude Code 風格工具使用 Anthropic 風格的位址,讓 OpenAI 相容工具使用 /api/v1。完整逐步指南位於上方對應的協議章節。

CC Switch

在 Claude Code 分頁中,將 provider base URL 設為 https://aireiter.com/api — 指南位於「Messages protocol → CC Switch (GUI)」。在 Codex 分頁中使用 https://aireiter.com/api/v1 — 指南位於「Responses protocol → CC Switch (GUI)」。

OpenClaw

使用 api: "openai-completions" 時,將 baseUrl 設為 https://aireiter.com/api/v1;使用 api: "anthropic-messages" 時,使用 https://aireiter.com/api。逐步指南位於「Chat protocol → OpenClaw」。

業界一致性OpenAI 相容閘道如何撰寫 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 相容用戶端 → Chat;如果你不想編輯設定檔,就使用 CC Switch GUI。