總覽

運作方式

Gateway 位在你的 client 與上游模型 provider 之間。不論你用哪種 SDK 格式，每個請求都會經過相同的四個階段。

驗證

Project API key 會先被驗證，並在轉送上游前移除 — provider 永遠看不到你的 ATP key。缺失、被停用或過期的 key 會以 401 拒絕。見驗證方式。

請求的模型必須在該 project 的 allowed list 上。若不在，會在送到任何 provider 前以 403 拒絕 — 模型存取權是設在 project、不是設在 key。見模型查詢。

Gateway 會從該模型設定的 provider pool 挑一個，遇到 provider 錯誤或逾時就 fail over 到另一個，因此同一個 model id 能跨 provider 保持穩定。見 Provider routing & fallbacks。

Input 與 output tokens 會被計量，並以 credits 從該 project 餘額扣款。餘額耗盡時請求會以 402 拒絕。見點數如何運作。

Gateway 轉譯驗證與路由，但把你的 request 與 response body 維持在 SDK 本來就預期的形狀。

因為 wire format 原樣通過，把既有的 OpenAI、Anthropic 或 Gemini 整合搬過來，通常只是改 base URL 與 key。

三種可接受的 key 放置位置，以及 401 到底代表什麼。

把 model id 寫死之前，先列出這把 project key 能呼叫哪些模型。

pool 怎麼排序，以及 Gateway 什麼時候會切到下一個 provider。

哪些東西會被計量，以及 project 餘額用完時會發生什麼事。