身分驗證
依各 API 協定的標準方式安全地使用 AnyInt API 金鑰。
所有開發者 API 請求都需要有效的 AnyInt API 金鑰。請使用用戶端協定原生支援的請求標頭,以確保現有 OpenAI、Anthropic 與 Gemini SDK 能正常運作。
各協定推薦驗證方式
| 協定 | 推薦輸入 | 規範 API 基礎位址 |
|---|---|---|
| OpenAI 相容 | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Anthropic Messages | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| 異步媒體 | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/v1/async-tasks |
為相容常用用戶端,閘道也允許各協定使用受支援的 AnyInt 金鑰請求標頭,並在 Gemini 路由接受 key 查詢參數。應優先使用請求標頭,避免憑證進入 URL 或中間層日誌。
閘道會在服務商路由前取用 AnyInt 憑證,不會將該憑證作為上游服務商金鑰轉發。無效、過期或已撤銷的金鑰將被拒絕。
建立金鑰
在主控台建立 API 金鑰,並將其保存在伺服器端金鑰管理系統或環境變數中。
新簽發的 AnyInt 金鑰使用 sk- 前綴,後接 52 個 Base64URL 字元(總長度 55 個字元)。現有 ak_ 金鑰在主動輪換或停用前仍然有效。請完整複製主控台顯示的值,請勿自行新增或刪除前綴。
export ANYINT_API_KEY="your_api_key"安全指引
- 將金鑰保存在伺服器端密碼管理系統或環境變數中。
- 切勿將金鑰寫入前端代碼、原始碼儲存庫、日誌或 URL。
- 為不同應用與環境使用獨立金鑰。
- 若金鑰疑似外洩,請立即輪換。
- 請勿將 AnyInt 金鑰轉發給上游服務商。
測試驗證
先查詢模型清單,確認金鑰有效,再發送推理請求。
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"驗證失敗將返回 HTTP 401 及對應協定的錯誤格式。有效金鑰仍可能因餘額不足收到 402,或在無可用服務商時收到 503。
常見錯誤排查與處理
當 API 調用遇到異常時,請參考下表快速定位原因與解決方案:
| HTTP 狀態碼 | 典型原因 | 排查步驟與解決方案 |
|---|---|---|
| 401 Unauthorized | API Key 無效、已過期或請求頭缺失 | 檢查請求頭中的 Bearer Token 或 x-api-key 是否完整複製;在控制台 API 金鑰頁確認金鑰是否處於啟用狀態。 |
| 402 Payment Required | 帳戶餘額不足或月度預算耗盡 | 前往控制台完成帳戶儲值,或在金鑰詳情中調高月度消費額度限制。 |
| 403 Forbidden | IP 白名單攔截、環境隔離或權限不足 | 檢查 API Key 的工作區權限範圍,確認請求 IP 是否在允許的白名單內。 |
| 404 Not Found | 請求路徑錯誤或請求的模型 ID 不存在 | 確認 Base URL 路徑是否正確;調用 GET /v1/models 驗證模型標識符是否正確。 |
| 429 Too Many Requests | 達到速率限制 (RPM/TPM) 或並發上限 | 降低客戶端請求並發;在控制台申請提升限額或配置階梯重試 (Exponential Backoff)。 |
| 502 Bad Gateway | 上游供應商網路抖動或返回格式畸變 | AnyInt 網關會自動觸發跨渠道容災重試;若持續失敗請透過控制台日誌排查。 |
| 503 Service Unavailable | 當前所選模型的所有路由候選節點均不可用 | 請稍後重試,或切換至同能力梯隊的備選模型。 |
| 504 Gateway Timeout | 上游模型推理超時 (如超長推理鏈模型) | 檢查 Prompt 複雜度;調大客戶端超時時間;對推理模型開啟流式傳輸 (stream: true)。 |