常見問題
你可能想知道的每一件事
模型、API 存取、企業客製工作流程、部署與計費，一律用白話說明。
平台與存取
RealRelay.ai 本身是模型供應商嗎？
不是。RealRelay.ai 並非模型供應商，而是連接上游的模型供應商，提供可靠、穩定、安全且統一的智慧路由與模型存取。它支援多種與主流供應商相容的 API 格式，包括 OpenAI、Anthropic 與 Gemini。
用白話說，RealRelay.ai 是什麼？
RealRelay.ai 是一個統一的 Agentic AI 平台，提供統一而安全的模型存取，並具備 Agent 的開發、部署與執行能力。針對企業使用者，我們也提供私有／地端部署，以及依特定業務流程量身打造的 Agent 實作。
RealRelay.ai 是為誰設計的？
RealRelay.ai 服務位於中國大陸以外的國際開發者、新創團隊與企業客戶。我們提供統一而安全的 AI 模型路由，以及為全球營運設計的端到端 Agent 開發與部署服務。
一定要有技術背景才能用嗎？
不用。開發者可以直接使用 API 與控制台。業務團隊可以先看工作流程範例，再與我們聯絡討論客製實作，不必自己設計技術架構。
我該用哪個 base URL 和 API 密鑰？
把你的用戶端指向 https://www.realrelay.ai/v1，並使用控制台「API 密鑰」頁面建立的 API 密鑰，以 Authorization: Bearer 送出。Anthropic 風格的 x-api-key 與 Gemini 風格的 x-goog-api-key 標頭，也可以在各自對應的端點上使用。
既有的 OpenAI 整合需要重寫嗎？
通常不用。把 base_url 指向 https://www.realrelay.ai/v1，換上 RealRelay.ai 的 API 密鑰，再從目錄挑一個 model id。請求格式維持不變。
可以用哪些 SDK？
你可以使用 OpenAI 相容的 SDK，例如官方 Python 與 Node.js 的 openai 套件；也可以對 /v1/messages 使用 Anthropic SDK，或對原生 /v1beta 路徑使用 Gemini SDK。API 文檔提供可複製的 OpenAI 相容 Python 與 Node.js 用戶端、Anthropic SDK 和 cURL 範例。
你們原生支援 Anthropic 與 Gemini 端點嗎？
是。/v1/messages 使用 Anthropic 的請求格式，/v1beta/models/* 使用 Gemini 的格式，因此這些 SDK 只要換掉 base URL 與 API 密鑰就能繼續運作。
模型與路由
目錄資料是從哪裡來的？
來自維運人員從平台發布的目錄快照 —— 模型頁面會顯示發布日期。劃線的原價來自我們的通道刊例價紀錄；我們實際收取的價格一律來自平台。
自動的模型「容錯移轉」是怎麼運作的？
當你只用模型名稱發出請求時，RealRelay.ai 會依你的路由策略（預設為最低價格，可在控制台切換），在提供這個模型的通道中挑出最合適的一個。如果第一選擇的通道變慢或中斷，它會在 10 毫秒內立即改道到最佳備援通道，讓你的使用者不會遇到服務中斷。
我可以鎖定特定通道嗎？
可以。只寫模型名稱，讓閘道挑出提供這個模型且最便宜的通道；或在名稱前加上通道名，鎖定指定的那一個。路由策略（預設、最低價格、最低延遲）是控制台裡的帳戶層級設定。
我怎麼知道一個模型支援什麼？
目錄會列出最近一次已發布目錄快照所回報的上下文長度、工具、影像理解與推理等能力，以及支援的端點。
模型下線之後會怎樣？
網站反映最近一次已發布的目錄快照。模型從該快照移除後，其詳細頁面 URL 會回傳 404，並從 sitemap 移除。
支援串流與工具呼叫嗎？
串流透過標準的 stream 參數以 SSE 運作。工具呼叫取決於模型，目錄會列出哪些模型回報支援。
帳戶與計費
統一 API 密鑰是怎麼運作的？
RealRelay.ai 是一層代理封裝。使用一組 API 密鑰即可呼叫該密鑰可存取的模型。使用不含通道前綴的模型 ID 時，我們會在提供該模型的可用通道之間動態路由，並針對延遲或價格進行最佳化。
我在哪裡建立 API 密鑰？
在控制台的「API 密鑰」頁面。一組 API 密鑰可以帶額度、模型允許清單、到期日與 IP 允許清單，讓你為每個環境發不同的 API 密鑰。
計費是怎麼設計的？
你先在控制台的錢包預付額度，用量會依公布的費率按每 100 萬 token 扣除，以供應商的直接成本計價，沒有隱藏加價。圖像與媒體模型按次計費，目錄會在價格旁標示計費方式。
不同方案的計費有什麼差別？
隨用隨付是預付制，按每 100 萬 token 計費，並可設定硬性預算上限。企業方案按月開立發票，以信用額度結算，並包含 SLA 與 SSO。Sovereign Core 是完全隔離部署的年度客製合約。你可以隨規模成長更換級距；目前的儲值級距請看價格頁面。
餘額用完時會發生什麼事？
請求會回傳 402 insufficient_quota。在控制台為錢包儲值即可恢復服務。
我要怎麼核對詳細帳單？
RealRelay.ai 為模型請求提供詳細的 token 用量紀錄。使用者可以在控制台查詢這些紀錄，核對細項計費與費用組成。
付款之後可以申請退款嗎？
付款原則上不予退款。不過為了處理誤購的情況，使用者可在付款後 24 小時內申請退款。
隱私與企業方案
我的資料會送到哪裡？是否保有隱私？
在任何請求送達公開 AI 模型之前，RealRelay.ai 的個資遮蔽層會先遮蓋敏感內容（醫療資訊、卡號、密碼），回應則會安全地還原給你。若你需要最大程度的掌控，也可以把 RealRelay.ai 完全跑在自己的基礎設施上。
可以裝在我自己的伺服器上（地端部署）嗎？
可以。對合規要求嚴格的組織（政府、醫院、銀行），RealRelay.ai 可以部署在你自己的伺服器叢集，或隔離的本地雲端。在這種架構下，你可以更好地掌控相應的資料。安全頁面有主權部署選項的詳細說明。
速率限制是多少？
限制以每組 API 密鑰計算，並依方案而定；目前的數值會顯示在控制台。遇到 429 時，請以指數退避方式重試。
平台會儲存我的模型存取資料嗎？
不會。RealRelay.ai 不儲存也不分析使用者的模型存取資料。它僅作為路由閘道，在使用者與模型供應商之間透明轉送資料。
平台會用我的資料來優化自身能力嗎？
不會。RealRelay.ai 嚴格遵守使用者隱私保護原則，絕不會使用任何使用者資料來訓練或優化平台能力。
平台如何與模型供應商合作？
RealRelay.ai 透過模型供應商的官方企業 API，與其簽訂直接的企業合約來取得模型存取。在這些企業協議下，供應商會提供更嚴格的資料隱私保護，以及更穩定的 API 服務。