AI API 接入方式怎麼選:官方 API、雲廠商託管與聚合閘道器對照
常見的 ai api 接入方式有三種:直接用模型廠商的官方 API,透過雲廠商託管的模型服務呼叫,或者走一個聚合閘道器。粗略的分法是:需要合同、發票和資料區域約束的團隊看雲廠商託管;只用一兩家模型、能用廠商支援的方式付款的,用官方 API;要在多個模型之間切換、希望用人民幣按月付費的個人開發者和小團隊,可以考慮聚合閘道器。
文末有一張閘道器檢查表和三條命令,可以用自己的網路和賬單去驗證。
三種接入方式分別指什麼?
官方 API:直接向模型廠商註冊賬號、繫結付款方式、拿到 API Key,請求發到廠商自己的域名,例如 api.openai.com、api.anthropic.com。模型最新、文件最全,出問題時對接的也是廠商本身。
雲廠商託管:大型雲平臺把第三方模型部署在自己的基礎設施上,透過雲平臺的賬號體系和計費呼叫。同一個模型可以有好幾個託管方。cdnping 模型監測讀取的 OpenRouter 公開資料裡,同一個 Anthropic 模型同時列出了 Anthropic 自己、Amazon Bedrock、Google Vertex(global、us、europe 等區域)、Azure 等多個供應商(資料截至 2026-10-17)。請求最終跑在哪家機房上,取決於你選的是哪個入口。
聚合閘道器:一個統一的介面地址加一把 Key,後面接多個模型供應商。客戶端通常只需要改“介面地址 + API Key”兩處配置。閘道器負責路由、計費和故障切換。這一類服務差異很大,有模型目錄性質的平臺,有訂閱制服務,也有來源不明的中轉站。
六個維度怎麼比?
| 維度 | 官方 API | 雲廠商託管 | 聚合閘道器 |
|---|---|---|---|
| 付款方式 | 通常需要廠商支援的國際信用卡,按量計費 | 走雲賬號計費,可按雲平臺流程籤合同、開票 | 視服務而定,有的支援人民幣、按月訂閱 |
| 可用率由誰負責 | 模型廠商 | 雲廠商(模型由其託管) | 閘道器運營方 + 上游供應商,兩層 |
| 模型覆蓋 | 只有這一家的模型 | 雲平臺上架的模型,上架時間可能晚於廠商 | 多家模型,一個 Key 切換 |
| 資料政策 | 看廠商條款 | 看雲廠商條款,一般可選部署區域 | 多了一箇中間方,要單獨看它的條款 |
| 延遲 | 一跳到廠商入口 | 一跳到雲區域入口 | 多一跳閘道器,取決於閘道器部署位置 |
| 合規 | 受廠商服務地區限制 | 受雲平臺區域和合同約束 | 受閘道器和上游雙重約束,部分閘道器並非官方授權渠道 |
可用率“兩層”意味著什麼?
走官方 API 時,故障只來自一個地方,看廠商狀態頁就夠了。cdnping 每 15 分鐘同步各家狀態頁,從 2026-09-17 到 2026-10-17 這一個月裡,OpenAI 狀態頁記錄了 4 次 major、19 次 minor 事件,Claude 狀態頁記錄了 6 次 major、1 次 minor 事件,Moonshot 記錄了 8 次 critical 事件。狀態頁的事件等級怎麼理解,可以看怎麼看 OpenAI 狀態頁和 Claude 狀態頁。
走聚合閘道器時,故障可能來自上游廠商,也可能來自閘道器自身。好的閘道器能把上游故障切到別的供應商,差的會把兩層故障疊在一起。所以選閘道器時,要看它是否公開按真實請求計算的可用率,以及什麼算失敗。
同一個模型,換個託管方會不一樣嗎?
會。可用率、延遲和量化精度都可能不同。OpenRouter 公開資料顯示,同一個模型在不同推理供應商上的近 1 天可用率有明顯差別,有的標註為 fp8 或 fp4 量化。具體數字和讀法見同一模型換個 OpenRouter 供應商,可用率能差多少和推理供應商與 fp8、fp4 模型量化。這一點對雲廠商託管和聚合閘道器都適用:你需要知道請求最後落在了誰那裡。
延遲差在哪一跳?
延遲主要由三段組成:建立連線(DNS、TCP、TLS)、閘道器往返、首 token 時間。前兩段跟接入方式關係最大。cdnping 在 2026 年 10 月 17 日的邊緣探測(Cloudflare 丹佛節點,08:40–10:05 UTC,共 242 次探測)中,海外官方 API 入口的往返中位數大多在 100 毫秒以內,國內平臺入口在 350–630 毫秒之間。這是美國邊緣節點到各入口的資料,不代表你在國內的實際體驗,視窗也很短,只能說明“入口位置決定了基礎延遲”。在你自己的網路下測,開啟 cdnping 線上測速即可,它會分開顯示“首次連線”和“往返”。延遲拆解的方法見 AI API 延遲拆解,國內網路的背景知識見國內訪問 AI API 的延遲。
怎麼決定用哪一種?
按順序回答下面幾個問題,遇到第一個“是”就基本有答案:
- 公司需要籤合同、開增值稅發票、指定資料存放區域嗎?是 → 雲廠商託管,或者廠商提供的企業合同(如果有)。
- 只用一家廠商的模型,並且能合規地用該廠商支援的付款方式付款嗎?是 → 官方 API,鏈路最短,責任最清楚。
- 需要在多家模型之間頻繁切換,比如編碼用一個、批次中文任務用另一個?是 → 可以考慮聚合閘道器,按下一節的檢查表篩選。多模型怎麼分工見多模型路由怎麼做。
- 以上都不是,只是想試試?先小額按量試用,等用量穩定了再決定。
不管選哪種,都要遵守模型廠商的服務條款和所在地法規。部分模型和服務有地區限制,請按條款使用,不要試圖繞過。
選聚合閘道器前,先做這 6 項檢查
| 檢查項 | 看什麼 | 怎麼驗證 |
|---|---|---|
| 身份 | 是否說明自己是不是官方授權渠道 | 看官網說明和條款 |
| 可用率 | 是否公開,按真實請求還是按探測計算,什麼算失敗 | 調它的公開介面,自己算一遍 |
| 計費 | 計量單位如何換算成 token,按月還是按量 | 小額試用,對照用量明細 |
| 資料 | 請求正文是否落盤、是否用於訓練或轉售 | 看隱私條款原文 |
| 模型來源 | 哪些模型標註了地區限制 | 看模型頁,不要憑印象 |
| 介面相容 | 是否同時相容 OpenAI 和 Anthropic 格式 | 用你實際的工具跑一次 |
更完整的 8 項檢查見 AI API 中轉站怎麼選,風險自查見 Claude API 中轉靠譜嗎。
以 AGI Plan 為例
先說明關係:AGI Plan 是 cdnping 的商業合作方。拿它舉例,是因為它的可用率資料可以公開拉取,同樣的方法可以用來檢查別的閘道器。
- 身份:站方明確說明自己不是官方授權渠道。
- 付款:按月訂閱,人民幣結算,不需要海外信用卡;也可以按量付費(1 元 = 500 CU,¥20 起充)。套餐見 agiplan.dev/pricing。
- 介面:同時相容 OpenAI 和 Anthropic 兩種格式,Claude Code、Codex、OpenCode 等工具只改一個介面地址。
- 資料:請求正文預設不落盤,內容不訓練、不轉售。
- 模型:部分模型標註為“僅境外”,以 agiplan.dev/models 為準。
- 可用率:公開逐小時、逐能力組的成功和失敗計數,只有 5xx 算平臺失敗。
截至 2026-10-17 的近 30 天資料(來源:AGI Plan 公開介面,cdnping /status/agiplan 映象):
| 能力組 | 近 30 天可用率 | 近 30 天請求數 |
|---|---|---|
| 國產模型組 | 98.0% | 9,436 |
| 均衡組 | 95.0% | 3,625 |
| 前沿模型組 | 94.4% | 33,729 |
| 快速組 | 81.7% | 44,729 |
快速組明顯偏低。列出這組數字,是因為能否看到原始計數本身就是檢查項:如果一個閘道器只給一個籠統的百分比,不說口徑,也不給原始計數,就沒法驗證。
三條可以直接跑的驗證命令
1. 拉取閘道器公開的可用率原始資料,自己算
curl -s "https://agiplan.dev/api/status/requests?month=2026-10&format=json" -o req.json
# 不加 format=json 預設返回 CSV
拿到逐小時的成功和失敗計數後,按“成功 /(成功 + 平臺失敗)”自己算一遍,看和頁面上展示的是否一致。其他閘道器如果提供類似介面,用同樣的方法核對。
2. 分段測量到介面入口的連線耗時
for host in api.openai.com api.anthropic.com agiplan.dev; do
curl -s -o /dev/null -w "$host dns=%{time_namelookup} tcp=%{time_connect} tls=%{time_appconnect} total=%{time_total}\n" "https://$host/"
done
多跑幾次取中位數。如果 tls 遠大於 tcp,說明握手階段慢,可能是線路或代理問題;網路層的排查可以參考 Claude Code 連線超時和報錯怎麼排查。
3. 改介面地址前後對比同一個請求
在客戶端裡只改介面地址和 Key,其他引數不變,同一個提示詞各跑若干次,記錄首 token 時間和總耗時。Claude Code、Codex、OpenCode 的具體配置方法見自定義 API 與介面地址配置。
選完之後還要盯什麼?
上線後建議持續看三件事:
- 上游狀態:官方 API 看 API 狀態;用閘道器時,閘道器自己的狀態和上游廠商的狀態都要看。
- 模型和供應商變化:模型下架、調價、量化精度變化,模型監測會自動記錄;價格頁和更新日誌的變化可以訂閱 官網動態。追蹤方法見大模型 API 價格變了怎麼第一時間知道。
- 自己的賬單:每月對一次用量明細和實際呼叫量,偏差大時先查是不是客戶端在重試。
懷疑是服務故障還是自己網路的問題,可以先開啟掛了嗎對照官方狀態和使用者報告,步驟見 ChatGPT 掛了嗎?三步判斷。