常見問題

關於 Synthorai 的常見問題。

Synthorai 支援哪些 SDK？

OpenAI SDK（透過 /v1/chat/completions 和 /v1/responses）和 Anthropic SDK（透過 /v1/messages）。將 baseURL/base_url 設定為你的閘道並使用你的閘道 API key —— 無需任何其他程式碼變更。

我應該把哪個 base URL 貼到我的工具裡？

兩條規則即可涵蓋：OpenAI 風格的工具（Codex、Cursor、Continue、Aider、LangChain ChatOpenAI、原生 OpenAI SDK）需要在 origin 後附加 /v1。Anthropic 風格的工具（Claude Code、Anthropic SDK、LangChain ChatAnthropic）需要不帶 /v1 的 origin —— SDK 會自行加上 /v1/messages。Tool Compatibility 頁面提供了完整的對照表。 查看頁面 →

我設定了環境變數，但工具仍然連接到原始供應商。我漏了什麼？

新的環境變數只對你編輯設定檔之後開啟的 shell 生效。請開啟一個新終端機，或在目前終端機執行 source ~/.zshrc / source ~/.bashrc。可用 echo $OPENAI_BASE_URL 或 echo $ANTHROPIC_BASE_URL 驗證。

我如何知道有哪些模型名稱可供我使用？

執行 curl https://synthorai.io/v1/models -H "Authorization: Bearer YOUR_KEY"，或前往 Console → Model Pricing。將 id 欄的值作為請求中的 model 參數傳入 —— 閘道會自動處理路由。

我可以將 Anthropic SDK 用於非 Claude 模型嗎？

不行。/v1/messages 只會透過已設定的 Anthropic 或 Bedrock-Anthropic 通道路由到 Claude 模型。對於其他供應商，請使用 /v1/chat/completions，它適用於所有已路由的模型。

新專案應該選擇哪種協定？

為獲得最大相容性，請使用 /v1/chat/completions —— 它適用於所有供應商。需要 OpenAI 工具呼叫和推理時，使用 /v1/responses。如果你統一採用 Anthropic SDK，則使用 /v1/messages。

配額用盡後會發生什麼？

請求將回傳 403 狀態碼，錯誤類型為 "quota_exceeded"。你可以在 Console → Limits & Billing 中儲值。

用量是如何計算的？

用量以 token 計量。輸入和輸出 token 分別計數，並在每個 API 回應的 usage 欄位中回報。

我可以設定每位使用者的配額嗎？

可以。管理員可在 Console → Members 中設定每位使用者的 token 配額。

請求會被記錄嗎？

是。所有請求都會記錄模型、token、延遲和狀態。日誌保留 30 天，可在 Console → Logs 中查看。

想在不同模型之間比較支出?model price comparison 列出每個可路由模型的按 token 價格,而 LLM API cost calculator 能把你的 token 用量換算成每月帳單估算。