快速開始

RouteAPI 為 OpenAI 相容、Claude Messages 和 Google Gemini API 提供統一的認證入口。本指南會帶你從註冊帳號、建立 Token，到驗證第一條請求，再依照場景選擇接入方式。

三步完成接入

註冊帳號。 開啟 RouteAPI 控制台，使用郵箱或 Google 註冊。儀表板可查看餘額、用量和帳號狀態。
建立 Token。 開啟 令牌管理 → 建立密鑰，填寫名稱與到期時間，並按需設定額度和模型限制。
發送測試請求。 將新 Token 設為 ROUTEAPI_KEY，選擇可用模型並執行下方 cURL 範例。

發送請求

OpenAI 相容介面是最快的驗證方式：

export ROUTEAPI_KEY="sk-your-routeapi-token"
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":"你好，RouteAPI"}]}'

回應包含助手訊息和用量資訊。若 API 或客戶端回傳請求 ID，請保存它以便排查問題。如果模型不可用，請替換為 GET /v1/models 回傳的模型 ID。

選擇接入方式

直接呼叫 API 使用 cURL 或任意 HTTP 客戶端，不增加額外依賴。

OpenAI 相容 SDK 保留現有 OpenAI SDK 程式碼，只替換 API Key 和 Base URL。

開發者工具為 Codex、Cursor、Claude Code、OpenCode、LangChain 或 LiteLLM 設定 RouteAPI。

Node.js 與 Python

選擇執行環境，安裝對應的官方 OpenAI SDK，並將 Base URL 指向 RouteAPI：

bun add openai
pip install openai

import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.ROUTEAPI_KEY, baseURL: 'https://api.routeapi.ai/v1' });
const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: '用一句話介紹 RouteAPI' }],
});
console.log(response.choices[0].message.content);

查看完整的 Node.js、Python 和 OpenAI SDK 範例。

使用串流輸出

將 stream 設為 true，即可透過 SSE 逐步接收輸出；收到 data: [DONE] 後結束。詳見串流回應。

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","stream":true,"messages":[{"role":"user","content":"用三點說明 RouteAPI"}]}'

驗證與排查

curl https://api.routeapi.ai/v1/models -H "Authorization: Bearer $ROUTEAPI_KEY"

401 — 檢查 Token 與 Authorization 標頭。
402 — 檢查帳戶餘額或 Token 額度。
429 — 降低請求頻率。
502/503 — 檢查模型服務並限制重試次數。
模型不可用 — 確認模型 ID 和能力。

參閱請求排查與常見錯誤。控制台使用日誌會記錄狀態、延遲、Token、費用和錯誤。

下一步

API 概覽了解協議入口、Base URL、標頭和能力範圍。

模型與價格查看模型 ID、能力、可用性和目前價格。

路由與故障保護在正式環境前了解服務路徑和故障保護。

正式環境請將 Token 保存在伺服器、固定模型 ID、記錄請求 ID，並用實際模型驗證串流、工具呼叫、結構化輸出與多模態功能。