跳到內容
RouteAPI RouteAPI

API 概覽

RouteAPI 提供面向企業的統一 AI API 接入能力，把 OpenAI、Claude、Gemini、Azure、AWS Bedrock 等模型能力聚合到一套穩定、可觀測、可計量的介面體系中。業務系統只需要接入 RouteAPI，即可在統一鑑權、統一模型 ID 和統一日誌下呼叫不同模型服務。

三步接入

Section titled “三步接入”

如果你已經在用任意 OpenAI 相容 SDK，改兩個設定就能跑通：

Terminal window
curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{ "role": "user", "content": "你好" }]
  }'
  1. 把 Base URL 換成 https://api.routeapi.ai/v1。
  2. 把 API Key 換成 RouteAPI Token（在控制台 API Keys 頁面建立）。
  3. 把 model 換成帳戶可用的模型 ID，用 GET /v1/models 查詢。

已有 OpenAI 應用的完整切換步驟見從 OpenAI 遷移。

支持的協議入口

Section titled “支持的協議入口”

RouteAPI 同時支持 OpenAI 相容、Claude Messages 和 Google Gemini 三套主流協議。你可以繼續使用現有 SDK 或客戶端，只需把 Base URL 和 API Key 切換到 RouteAPI。

協議典型介面適合場景
OpenAI 相容/v1/chat/completions、/v1/responses、/v1/embeddingsOpenAI SDK、Cursor、OpenCode、LangChain、LiteLLM 等相容客戶端
Claude Messages/v1/messagesClaude Code、Anthropic SDK、Claude 原生訊息格式客戶端
Google Gemini/v1beta/models/{model}:generateContentGoogle GenAI SDK、Gemini REST 客戶端

不同協議進入的請求會在 RouteAPI 內部完成必要的格式適配。對業務側來說，優先選擇當前客戶端原生支持的協議即可——原生協議不經過轉換，行為最可預期。跨協議呼叫（例如用 OpenAI 格式呼叫 Claude 模型）的映射規則和已知損失見協議轉換說明。

基礎位址

Section titled “基礎位址”

OpenAI 相容和 Claude Messages 協議預設使用：

https://api.routeapi.ai/v1

Google Gemini 協議預設使用：

https://api.routeapi.ai/v1beta

通用請求標頭

Section titled “通用請求標頭”
Authorization: Bearer sk-your-routeapi-token
Content-Type: application/json

所有協議都使用同一類 RouteAPI Token。請在伺服器端保存 Token，不要把 Token 暴露到瀏覽器、行動端或公開儲存庫中。詳細的金鑰權限、額度和認證錯誤見認證方式。

Claude Messages 協議也接受 Anthropic SDK 慣用的 x-api-key 請求標頭，因此使用 Anthropic SDK 時通常只需改 Base URL。

介面與能力索引

Section titled “介面與能力索引”

按你要做的事選入口：

我要做的事用哪個介面文件
一般多輪對話/v1/chat/completionsChat Completions
編碼代理、新協議客戶端/v1/responsesResponses
向量檢索、語意搜尋、RAG/v1/embeddings向量嵌入
查詢可用模型和能力/v1/modelsModels
讓模型呼叫外部函式tools 參數工具呼叫
讓模型按固定 JSON 結構輸出response_format 參數結構化輸出
傳圖像給模型理解多模態 content多模態輸入
逐字回傳、降低首字延遲stream: true串流回應
AI 音樂生成Suno REST APISuno API

協議相容範圍

Section titled “協議相容範圍”

RouteAPI 會盡量保持各協議的原生呼叫體驗，同時把請求轉發到合適的模型服務。實際支持能力取決於模型、服務能力和請求參數：

能力說明
Chat Completions建議的基礎聊天介面，適合大多數 OpenAI SDK 相容客戶端
Responses適合支持 OpenAI Responses 協議的客戶端和編碼代理
Embeddings用於向量檢索、語意搜尋和 RAG
Streaming使用 SSE 回傳增量內容
Claude Messages支持 Claude 原生訊息結構，適合 Claude Code 與 Anthropic SDK
Google Gemini支持 Gemini generateContent 風格請求
Tool Calling取決於模型是否支持工具呼叫
Structured Outputs取決於模型是否支持 JSON mode 或 JSON Schema
Vision / Multimodal取決於模型是否支持圖像或多模態輸入

能力是按模型而非按平台提供的：同一個介面換個 model 就可能不再支持工具呼叫或圖像輸入。上線前請用目標模型實測，或查閱 Models 回傳的能力欄位。

介面穩定性約定

Section titled “介面穩定性約定”
  • 請求參數會盡量保留並按協議轉發。
  • 可選標量參數如果明確傳入 0、false，RouteAPI 應按明確值處理，而不是當作預設值丟棄。
  • 不同模型不支持的參數可能被適配、忽略或觸發錯誤，具體以模型相容規則為準。
  • 生產環境建議固定模型 ID，並為關鍵業務準備失敗備援策略。
  • 對工具呼叫、結構化輸出、視覺輸入和串流用量統計等可選能力，建議先在測試環境驗證再上線。

企業接入建議

Section titled “企業接入建議”
  • 伺服器端統一封裝 RouteAPI Token，避免業務前端直接持有金鑰。
  • 為不同業務系統使用不同 Token，便於獨立限額、稽核和問題定位。
  • 固定模型 ID 和協議路徑，不要依賴臨時別名或顯示名稱。
  • 記錄請求 ID、模型 ID、狀態碼、耗時和 token 用量，方便排查延遲與成本異常。
  • 對核心業務啟用串流逾時、失敗重試和備用模型方案，降低單一模型服務異常對業務的影響。

接下來

Section titled “接下來”