模型定價文件關於
登入[ 取得 API 金鑰 ]
cd ../back to blog
$Guide//June 4, 2026//7 min read

從 OpenRouter 搬到第一方等級閘道：一個 base_url 的差異

OpenRouter 主打廣度，第一方等級閘道主打保真度。誠實比較兩者適用時機，並示範只改 base_url、金鑰與模型 slug 的兩行搬家。

先講公道話:OpenRouter 是廣度之王。一把金鑰、一個 base URL,你就能 觸及 300+ 個模型 — 包含沒有任何第一方 API 會開放的開源長尾(Llama、 Qwen、DeepSeek、Mistral,以及數十個社群微調版本)。如果你的工作是 評測一整個寬廣的領域、在各家供應商之間繞過故障,或是接上某個小眾的 開放權重模型,那份目錄就是貨真價實、難以複製的強項。這篇文章不是要 把它批倒。

這是一份各有所長的指南。還有另一類工作 — 你想要的是擁有原生 功能、完好無損的真正第一方 旗艦模型,是能逐個權杖稽核的帳單,是同一把金鑰上的圖片與影片,以及一個 小到足以令人信任的單模型折扣。那正是各團隊會在 OpenRouter 旁邊再加上 像 Brievio 這種第一方等級閘道的時機,或乾脆把生產路徑整個搬過去。搬家 本身只是一行 base_url 改動,加上模型 slug 的更名。以下是這個誠實的取捨與實作機制。

什麼時候該選 OpenRouter

在動手改任何東西之前,先把這點看清楚。下列情況下 OpenRouter 是更合適的 選擇:

  • 你需要開源長尾。Llama、Qwen、DeepSeek、Mistral 以及社群微調版本,都不在任何第一方 API 上。如果你的路線圖會碰到 開放權重模型,你會想要那份目錄。
  • 你正在跑大規模評測。跨五家供應商比較二十個模型, 正是一個 300 模型聚合器的拿手好戲。一把金鑰、一套格式、所有模型。
  • 你想把跨供應商容錯當成一項功能。 OpenRouter 能針對某個模型在多家上游供應商之間退而求其次。對某些 可用性需求來說,這種廣泛的路由能力正是重點。
  • 你在比價,找某個開放模型最便宜的供應端。這個市集會 列出同一模型的多家供應商,並讓你依價格排序。那是個實實在在的籌碼。

加上 Brievio 之後,以上這些一個都不會消失。許多團隊正是為了這些工作而 留著 OpenRouter,只把第一方的生產流量指向別處。兩個 base URL,一份 程式碼。

什麼時候第一方等級閘道更合適

要切換(或分流流量)的理由比較窄、也比較具體。當下列這些事很重要時, 就該考慮它:

  • 你需要真正的第一方模型,而且原生功能完好無損。不是 微調版、也不是近似的替代品 — 而是貨真價實的 Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 與 Gemini 2.5 Pro / Flash, 原生工具呼叫、視覺、提示快取都按供應商文件所述正常運作。當旗艦模型 的行為就是你的產品時,「差不多就好」是不夠的。
  • 你想要能稽核的誠實權杖計費。你真正的成本是 費率 × 權杖數,而權杖數正是最容易被灌水的那個數字。Brievio 回報真實 的第一方權杖數,並照實計費。如果你從沒查過,這裡有一段 二十行的自我檢測。
  • 你想要圖片與影片都在同一把金鑰上。Nano Banana 與 Nano Banana Pro、GPT-Image-2、Veo 3,都坐在跟你的對話模型相同的 憑證與相同的 OpenAI 格式用戶端之後 — 不必另開第二個供應商帳號, 也沒有另一份計費介面。
  • 你想要一個小到足以信任的折扣。 對話模型約比官方定價低 15%,圖片與影片約低 37.5%,而且每個模型都對照官方參考費率公開,讓你 能稽核這個價差。一個適度、說得清楚的折扣,是靠量做出來的毛利 — 而 不是某種得在你看不到的地方補回來的補貼。
  • 失敗的呼叫免費。4xx 與 5xx 回應不計費,所以上游 某天狀況不好,並不會悄悄變成你帳單上的一筆。

搬家:一個 base_url、一把金鑰

因為兩個閘道都實作了 OpenAI Chat Completions API,這次切換是你程式碼裡 最小的一筆差異。你把 SDK 指向新的主機,再換掉金鑰。串流、函式呼叫、 JSON 模式以及你的請求格式都不動:

swap_base_url.py
# 從 OpenRouter 搬家只是兩行差異:換掉 base_url 與金鑰。
# 其他一切 — OpenAI SDK、你的請求格式、串流、工具 —
# 都原封不動,因為兩邊講的都是 OpenAI Chat Completions API。

from openai import OpenAI

# --- Before: OpenRouter ---
client = OpenAI(
    api_key="sk-or-...",
    base_url="https://openrouter.ai/api/v1",
)

# --- After: Brievio ---
client = OpenAI(
    api_key="sk-brievio-...",
    base_url="https://api.brievio.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",                 # 模型名稱對照見下方
    messages=[{"role": "user", "content": "Summarize this contract clause…"}],
)

如果你當初就是從官方 OpenAI SDK 轉到 OpenRouter 的,這會很熟悉 — 它跟 我們那篇 十分鐘從 OpenAI 搬家是一模一樣的動作,只是換了個來源。不必換新 SDK,也不必重寫你的呼叫 點。

你唯一要改的東西:模型 slug

這裡是唯一值得花幾分鐘留意的行為差異。OpenRouter 把每個模型都命名成 vendor/model — anthropic/claude-sonnet-4.6、 google/gemini-2.5-flash — 因為在橫跨眾多供應商的 300+ 個 模型下,命名空間能避免撞名。Brievio 提供的是精選的第一方模型組,所以 slug 是純的: claude-sonnet-4-6、gemini-2.5-flash。沒有 vendor/ 前綴。

model_mapping.py
# 你唯一要動的東西:模型 slug。
# OpenRouter 把每個模型都命名成 "vendor/model",讓來自眾多供應商的
# 300+ 個模型永不撞名。Brievio 提供的是精選的第一方模型組,
# 所以 slug 是純的 — 沒有 "vendor/" 前綴。

MODEL_MAP = {
    # OpenRouter slug                ->  Brievio slug
    "anthropic/claude-opus-4.7":         "claude-opus-4-7",
    "anthropic/claude-sonnet-4.6":       "claude-sonnet-4-6",
    "anthropic/claude-haiku-4.5":        "claude-haiku-4-5",
    "google/gemini-2.5-pro":             "gemini-2.5-pro",
    "google/gemini-2.5-flash":           "gemini-2.5-flash",
    # 圖片 + 影片就在同一把金鑰上 — 不必另開供應商帳號:
    # "nano-banana", "nano-banana-pro", "gpt-image-2", "veo-3"
}

def to_brievio(slug: str) -> str:
    return MODEL_MAP.get(slug, slug.split("/")[-1])

# 給 Claude/Gemini 的務實捷徑:去掉前綴,把版本號的點換成連字號。
# "anthropic/claude-sonnet-4.6" -> "claude-sonnet-4-6"。每一個都拿去
# 對 /models 確認,這樣打錯字會大聲報錯,而不是默默把流量路由到錯的地方。

對 Claude 與 Gemini 來說,規則很機械化:去掉前綴,並把版本號用連字號 而非點來呈現 (4.6 → 4-6)。請維護一份小小的對照字典,而不是 盲目地做字串拼接,並把每一個 slug 拿去對 模型清單 驗證,這樣打錯字會在啟動時大聲 報錯,而不是默默路由到錯的地方。這是整個搬家過程真正需要做的唯一一次 尋找與取代。

務實的上線方式

你不必一次就全部決定。風險最低的路徑,是把這兩個閘道當成互補:

  • 讓它們並肩運作。把 OpenRouter 留給開源長尾與你的 評測框架。把 Brievio 當成第二個用戶端,負責生產路徑裡的第一方旗艦 模型。兩個 base URL,一個 repo。
  • 切換之前先做影子流量。把一小部分線上流量鏡像到 Brievio,並比對回應與 usage 物件。你要確認的是:這個模型是真正的第一方模型, 而且權杖數和你預期的對得上 — 那篇 權杖自我檢測 就是把這項檢查自動化。
  • 先把多模態的工作搬過來。如果你今天還在拼接另一個 獨立的圖片或影片供應商,把 Nano Banana / GPT-Image-2 / Veo 3 整併到同一把金鑰上,往往是最乾淨 的早期勝利 — 更少帳號、一份帳單、一條認證路徑。
  • 等差異變得無聊時再正式採用。一旦影子流量對得上、 數字也兜得攏,就把生產預設切過去。萬一有任何意外,只要還原一個 base_url 就能回滾。

誠實的結論

OpenRouter 與第一方等級閘道,其實不是在爭同一份工作。OpenRouter 為觸及範圍而最佳化 — 一把金鑰下最寬廣的目錄與開源長尾,這是 既真實又有價值的東西。Brievio 則為精選模型組上的保真度 而最佳化 — 原生功能完好無損的真正第一方旗艦模型、誠實且可稽核的權杖 計費、同一把金鑰上的圖片與影片,以及一個小到足以信任的單模型折扣。 兩者都坐在單一的 OpenAI 相容 base_url 之後,而這正是為什麼 這麼多團隊兩個都用:需要廣度的地方用廣度,看重保真度的地方用保真度。

如果你想要的是擁有原生行為、且帳單可驗證的真正第一方模型,這次搬家只 花你一個 base_url、一把金鑰,以及一次模型 slug 的更名。 到 Brievio 與 OpenRouter 對照讀讀 並排比較,在 模型清單上瀏覽確切的模型與 slug,並在把真實流量放到任何地方之前,先對兩邊都跑一遍 權杖自我檢測。 這個決定無論朝哪邊都經得起檢視 — 而那才是唯一值得上線的那種決定。

$ ls ./related