連接應用程式與程式代理

使用一組 Route Key API 金鑰與相容閘道,連接應用程式、SDK 與程式工具。

步驟 01

連接 AI 應用程式

三個值就能送出第一個相容請求。

  • Base URLhttps://api.routekey.ai/v1
  • AuthorizationBearer YOUR_ROUTEKEY_API_KEY
  • 模型從 Models 選擇啟用的完整 ID。
第一個可用請求
curl https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ROUTEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<route-key-model>","messages":[{"role":"user","content":"Hello"}]}'
步驟 02

設定程式代理

每個工具使用專用金鑰,再複製對應的設定檔。

Install Codex官方文件
npm install -g @openai/codex
~/.codex/config.toml
model = "<route-key-coding-model>"
model_provider = "routekey"

[model_providers.routekey]
name = "Route Key"
base_url = "https://api.routekey.ai/v1"
env_key = "ROUTEKEY_API_KEY"
  • 建立專用 Route Key API 金鑰。
  • 在 Models 選擇啟用模型。
  • 重新啟動工具並確認用量記錄。
營運檢查清單

讓每個整合都容易維護

OpenAI 相容性可減少遷移工作,但仍需要每個工具的金鑰、測試過的模型、可設定的 base URL 與可觀測性。 模型.

準備安全且可重現的 API 連線

建立並保護 API 金鑰

從工作台建立金鑰,為每個應用程式或工具使用專用金鑰,並放在環境變數或秘密管理器中,勿寫入程式碼與記錄。

理解請求的三個值

Base URL 選擇閘道、Bearer token 驗證請求、模型 ID 選擇啟用模型。請使用 Models 頁面的完整 ID。 模型.

全面上線前確認存取

確認餘額或額度、模型群組與端點支援的請求類型。短小的非串流請求最容易找出問題。

確認第一個回應並查看用量記錄
  1. 送出短請求,檢查一般回應或串流內容。
  2. 記錄回應的模型 ID 與端點,方便重現設定。
  3. 在用量記錄確認請求、Token、延遲與成本。
  4. 逐項加入串流、工具、長內容與並行請求。

401 或 403 驗證錯誤

確認 Authorization: Bearer 前綴、空白、金鑰狀態與 /v1 base URL。

找不到模型或無法使用

從 Models 複製啟用的模型 ID,並確認群組與端點。

額度、餘額或速率錯誤

檢查錢包、帳戶限制與用量記錄,降低測試的並行數或輸出長度。

可以使用現有的 OpenAI SDK 嗎?

通常可以。保留 SDK 請求格式,將 base URL 設為 Route Key /v1,並傳入 Route Key API 金鑰。

多個工具應共用一組金鑰嗎?

不應該。每個應用程式或代理使用獨立金鑰,方便查看記錄與輪替。

要在哪裡調查成本差異?

在用量記錄比較模型、群組倍率、輸入輸出 Token、端點與時間,再查看價格目錄。