統一的 Claude、GPT、Gemini API
一個 AI in IDE 帳戶可經四種渠道連接 Claude、GPT 與 Gemini,各渠道的 Base URL、模型與額度係數不同。
一個帳號,四種渠道
金鑰在控制台的 API 密鑰頁面建立時就綁定渠道。渠道決定這把金鑰能調用哪些模型、接受哪一組端點,以及消耗你購買額度的速度。
| 渠道 | 模型 | 端點類型 | 額度係數 |
|---|---|---|---|
| AWSQ | Claude:claude-opus-5-5、claude-sonnet-5-5、claude-haiku-4-5-20251001。不支援 Fable。 | Anthropic Messages、OpenAI Chat Completions / Responses | 0.8 倍 |
| CCMAX | Claude,含 Fable、claude-opus-5-5、claude-sonnet-5-5 | Anthropic Messages、OpenAI Chat Completions / Responses | 2 倍 |
| Codex | 範例模型 gpt-6.1-sol | Responses、Chat Completions | 0.8 倍 |
| Gemini | Gemini Flash:gemini-3.5-flash、gemini-3.7-flash、gemini-3.8-flash | Gemini generateContent | 0.5 倍 |
係數是加在按站內模型基礎費率計算的請求成本上的倍率,不會改變你購買的額度數量。同一個模型走 0.8 倍的渠道就是比走 2 倍的渠道耐用,這也是 AWSQ 與 CCMAX 之間最實際的差別。
在 API Keys 變更現有金鑰的渠道後,同一個請求從 AWSQ(0.8 倍)改走 CCMAX(2 倍),會消耗原本 2.5 倍的額度。
Base URL 對照
| 用戶端 | 要填的值 | 用戶端會自動接上 |
|---|---|---|
| Claude Code、Anthropic SDK | https://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
| 工具 | 建議閱讀 |
|---|---|
| VS Code | 在 VS Code 中使用 Claude Code |
| Cursor | 在 Cursor 中使用 Claude Code |
| JetBrains | 在 JetBrains 中使用 Claude Code |
| Claude Code CLI | 設定說明 |
| Codex CLI | Codex 設定 |
| Gemini CLI | Gemini 設定 |
以上都不是一鍵安裝。每個流程都要先裝用戶端、填入 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 價格。