認證方式
RouteAPI 使用 Bearer Token 認證。所有 API 請求都需要在 Authorization 請求頭中攜帶有效 Token。
Authorization: Bearer sk-your-routeapi-token示例：
curl https://www.routeapi.ai/v1/models \ -H "Authorization: Bearer $ROUTEAPI_KEY"創建 API Token
Section titled “創建 API Token”- 登錄 RouteAPI 控制台。
- 打開api keys頁面。
- 創建新令牌。
- 根據需要設置名稱、額度、訪問權限和有效期。
- 保存令牌，並只在服務端或安全環境中使用。
Token 與權限
Section titled “Token 與權限”Token 通常會受到以下配置影響：
| 配置 | 影響 |
|---|---|
| 用戶餘額 | 餘額不足時請求可能返回 402 |
| Token 額度 | 單個 Token 可設置獨立額度或過期時間 |
| 頻率限制 | 觸發後返回 429 |
- 不要把 Token 暴露在前端代碼、公開倉庫或移動端明文配置中。
- 服務端調用時優先使用環境變量保存 Token。
- Token 洩露後立即禁用或刪除，並重新生成。
- 為不同應用創建不同 Token，方便審計和限額。
- 對臨時測試 Token 設置較低額度和過期時間。
常見認證錯誤
Section titled “常見認證錯誤”| 狀態碼 | 常見原因 | 處理方式 |
|---|---|---|
| 401 | 缺少 Token、Token 拼寫錯誤、Token 已刪除 | 檢查 Authorization 請求頭 |
| 402 | 餘額不足或額度耗盡 | 充值、提高額度或更換 Token |
| 429 | 觸發限流 | 降低併發，檢查用戶或 Token 限流配置 |