統一的 Claude、GPT、Gemini API

一個 AI in IDE 帳戶可經四種渠道連接 Claude、GPT 與 Gemini,各渠道的 Base URL、模型與額度係數不同。

一個帳號,四種渠道

金鑰在控制台的 API 密鑰頁面建立時就綁定渠道。渠道決定這把金鑰能調用哪些模型、接受哪一組端點,以及消耗你購買額度的速度。

渠道模型端點類型額度係數
AWSQClaude:claude-opus-5-5、claude-sonnet-5-5、claude-haiku-4-5-20251001。不支援 Fable。Anthropic Messages、OpenAI Chat Completions / Responses0.8 倍
CCMAXClaude,含 Fable、claude-opus-5-5、claude-sonnet-5-5Anthropic Messages、OpenAI Chat Completions / Responses2 倍
Codex範例模型 gpt-6.1-solResponses、Chat Completions0.8 倍
GeminiGemini Flash:gemini-3.5-flash、gemini-3.7-flash、gemini-3.8-flashGemini generateContent0.5 倍

係數是加在按站內模型基礎費率計算的請求成本上的倍率,不會改變你購買的額度數量。同一個模型走 0.8 倍的渠道就是比走 2 倍的渠道耐用,這也是 AWSQ 與 CCMAX 之間最實際的差別。

在 API Keys 變更現有金鑰的渠道後,同一個請求從 AWSQ(0.8 倍)改走 CCMAX(2 倍),會消耗原本 2.5 倍的額度。

Base URL 對照

用戶端要填的值用戶端會自動接上
Claude Code、Anthropic SDKhttps://api.aiinide.com/v1/messages
OpenAI 相容用戶端https://api.aiinide.com/v1/chat/completions 或 /responses
Codex CLI、Responses 用戶端https://api.aiinide.com/responses
gemini CLI、Gemini 用戶端https://api.aiinide.com/v1beta/models/...

兩條規則能擋掉大多數失敗的設定:

  • Anthropic 的 Base URL 只填網域。多寫 /v1 會變成 /v1/v1/messages,直接回 404。
  • 金鑰不能跨端點家族混用。把 Codex 金鑰送到 /v1/messages、或把 Gemini 金鑰送到 /api/codex,都會被拒絕並回 400,不會被悄悄轉送到別的後端。

Claude Code 會自行加上 /v1/messages。舊版整合仍支援 /api/anthropic 前綴。

各協議的第一個請求

Anthropic Messages

1
curl --globoff 'https://api.aiinide.com/v1/messages' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "Content-Type: application/json" \
5
  -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

加上 "stream":true 即為串流回應。

OpenAI 相容 Chat Completions

1
curl --globoff 'https://api.aiinide.com/v1/chat/completions' \
2
  -H "Authorization: Bearer YOUR_DASHBOARD_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

同一把金鑰也接受 POST /v1/responses,該介面改用 input 與 max_output_tokens,而不是 messages。

Codex Responses

1
curl --globoff 'https://api.aiinide.com/responses' \
2
  -H "Authorization: Bearer YOUR_DASHBOARD_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"model":"gpt-6.1-sol","input":"用三個要點說明這個儲存庫。"}'

Gemini generateContent

1
curl --globoff 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:generateContent' \
2
  -H "x-goog-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"contents":[{"role":"user","parts":[{"text":"ping"}]}]}'

四個渠道都能透過 GET /v1/models 取得 OpenAI 格式的模型清單。只有 AWSQ 和 CCMAX 金鑰可以加上 anthropic-version 標頭取得 Anthropic 格式。Codex 和 Gemini 金鑰須省略該標頭,否則會收到 400。

編輯器與 CLI

以上都不是一鍵安裝。每個流程都要先裝用戶端、填入 Base URL、存好金鑰,是幾分鐘的複製貼上,而不是一鍵幫你設定到好的安裝程式。

哪些行為照舊,哪些不一樣

請求本身的形狀與上游廠商文件一致:JSON 內容、串流事件名稱、工具呼叫區塊、快取控制都相同。不同的是帳號層:計費改從控制台的美元額度扣除、渠道係數生效、金鑰的額度與到期時間會在請求送出前先檢查。

走 OpenAI 相容路徑時,有幾項 Anthropic 專屬能力刻意不支援:背景生成、伺服器端保存的上下文(一律 store=false)、託管工具、Fast 模式與一小時快取延長。多輪對話請每回合送出完整內容;需要上述 Claude 專屬功能時,請改用 Anthropic Messages。

常見問題

一把金鑰能同時調用三家模型嗎? 不能。金鑰屬於單一渠道,一個渠道只覆蓋一個廠牌系列。同一個帳號可以同時持有 AWSQ、CCMAX、Codex、Gemini 四種金鑰,各自設定額度與到期日。

需要另外有 Anthropic、OpenAI 或 Google 帳號嗎? 不需要。控制台金鑰取代了上方所列用戶端的廠商登入與廠商計費。

為什麼請求回 400 而不是上游錯誤? 請確認端點接受金鑰所屬渠道,且該渠道支援所選的模型系列。請使用 GET /v1/models 傳回的完整 ID。

OpenAI 路徑用的是別的模型嗎? 不是。AWSQ 與 CCMAX 用兩種協議提供同一批 Claude 模型,差別只在請求與回應的封裝格式。

價格怎麼來的? 供應商參考價採用廠商公布的每百萬 Token 價格。標準用量的額度扣抵,則以 AI in IDE 設定的模型費率乘以渠道係數計算。詳見 Claude Code API 價格。

統一的 Claude、GPT、Gemini API|AI in IDE