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

從 OpenAI 遷移到 Brievio：十分鐘、改一行

保留現有 SDK 與程式碼，只改一行 base_url，即可在 Python、Node、LangChain、Vercel AI SDK 上切換到 Brievio。

如果你的應用程式已經在呼叫 OpenAI 的 API，改用 Brievio 大約只要十分鐘 — 其中大半時間還是花在註冊上。你保留原本的 SDK 與整套程式碼;換來的是跑在可靠基礎設施上的真正模型,搭配 誠實的權杖計費。本指南會逐一說明大多數團隊手上常見的四種整合方式, 以及各自只需改動的那一行。

第 0 步 — 取得金鑰(2 分鐘)

  1. 到 brievio.com/app/signup 註冊。 一註冊就有 $2 的額度;不必綁卡。
  2. 前往 /app/keys 建立一把金鑰。 它以 sk-brievio- 開頭。
  3. 設定環境變數: export BRIEVIO_API_KEY=sk-brievio-...。

第 1 步 — 切換你的 SDK(1 分鐘)

Python(openai 套件)

migrate.py
# 之前 — 直接指向 OpenAI
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
)

# 之後 — 指向 Brievio。其餘一切完全不變。
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com/v1",
)

Node / TypeScript

migrate.mjs
// 之前
import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

// 之後
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.BRIEVIO_API_KEY,
  baseURL: "https://api.brievio.com/v1",
});

LangChain

LangChain 內部用的是同一套 OpenAI 用戶端,所以改法完全一樣。 模型 id 現在改成 Brievio 的代稱 — 完整即時清單請見 /models(可以試試 claude-sonnet-4-6、gemini-2.5-flash、 claude-opus-4-7)。

langchain_setup.py
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",          # 換成這個模型
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com/v1",
)

Vercel AI SDK

@ai-sdk/openai 預設會從環境變數讀取它的 base URL 與 API 金鑰。設好這兩個就完成了 — 每一個框架輔助函式(streamText、generateObject、 重試、工具路由)都照舊運作。

vercel_ai.mjs
import { openai } from "@ai-sdk/openai";

// @ai-sdk/openai 會自動讀取 OPENAI_BASE_URL
process.env.OPENAI_BASE_URL = "https://api.brievio.com/v1";
process.env.OPENAI_API_KEY = process.env.BRIEVIO_API_KEY;

const model = openai("claude-sonnet-4-6");
// 接著照舊使用 streamText / generateText / streamObject

Anthropic SDK(如果你已經在用 Claude)

Brievio 在 /v1/messages 也提供 Anthropic 原生的 Messages API,跟 OpenAI 的格式並存 — 所以你不必更換 SDK。

anthropic_sdk.py
from anthropic import Anthropic

# 之前 — Anthropic SDK 連向 api.anthropic.com
client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

# 之後 — 同一套 SDK，改連 Brievio。快取、思考、工具一律照樣通過。
client = Anthropic(
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com",   # SDK 會自動接上 /v1/messages
)

第 2 步 — 冒煙測試錢包(1 分鐘)

在動到正式環境的程式碼之前,先對 claude-haiku-4-5 跑一個廉價的測試。如果這個能成功回傳, 代表你的金鑰沒問題、計費沒問題、路由層也很健康。

smoke_test.py
# 為驗證遷移而設的廉價、近乎可重現的冒煙測試。
resp = client.chat.completions.create(
    model="claude-haiku-4-5",            # 最便宜的 Claude
    messages=[{"role": "user", "content": "ping"}],
    max_tokens=8,
    temperature=0,
)
assert resp.choices[0].message.content, "empty response"
print("ok — Brievio 錢包正常運作，總花費約 $0.0001")

第 3 步 — 把流量切過來(5 分鐘)

安全的做法:在你的應用程式裡放兩個環境變數 — AI_BASE_URL 與 AI_API_KEY — 依不同環境 各自選用。正式環境先留在 OpenAI;測試環境換成 Brievio。觀察 24 小時後,再把正式環境也切過去。

如果你在切換前想先掌握成本影響, Brievio 的儀表板會把每次呼叫的成本與上游官方費率並列呈現 — 很容易就能用你真正的提示算出每月預估的差額。

有哪些維持不變

  • 你的 SDK 與整套程式碼。
  • 串流、函式呼叫、工具使用、視覺辨識、結構化輸出。
  • OpenAI 一模一樣的請求與回應結構。
  • 錯誤格式(error.message / error.type / error.code)。

有哪些變得更好

  • 真實性。每一次呼叫都是貨真價實的第一方模型 — 完整脈絡、原生工具與快取,沒有暗中降級,也沒有重新包裝的代理。
  • 定價。每個模型的定價大約都比供應商官方牌價低 15%,並依真實的權杖數計費 — 詳見 /pricing。
  • 多模態。同一套 SDK 就能觸及 Claude(claude-opus-4-7)、Gemini(gemini-2.5-pro)、 GPT-Image-2、Veo 3、Nano Banana — 詳見 /models。
  • 計費。Stripe 原生錢包 — 信用卡、Apple Pay、 Google Pay、ACH、SEPA、支付寶、微信支付。一張可稽核的帳單。
  • 可靠性。受監控的自動故障切換 — 上游一旦劣化我們 就立刻改道,通常在你的重試迴圈觸發之前就完成。

需要留意的非典型情況

  • 目前還沒涵蓋的 OpenAI 專屬端點: /v1/responses(請改用 /v1/chat/completions)、 /v1/assistants(狀態請自行保存;我們是無狀態 閘道)、/v1/realtime(規劃中)。
  • 某些 Claude 專屬功能 — cache_control、 擴充式 thinking — 透過原生的 /v1/messages 端點效果最佳, 而非 OpenAI 的格式。

卡關了?contact@brievio.com — 真人會在一個工作天內回覆。如果你正在進行一場 正式的遷移,我們會跟你約時間通話。

$ ls ./related