用 OpenAI 相容格式呼叫 Gemini API
用 OpenAI SDK 就能呼叫 Gemini：base_url 填 https://api.relayswitch.io/v1，金鑰換成 RelaySwitch 的，model 填 Gemini 的模型 id。目錄裡有 21 個 Gemini 模型，金鑰在控制台建立，不需要 Google 帳號，費用從預付餘額按 token 扣款。
01Gemini API Key 的兩種來源
Google 自己的 Gemini API，要用 Google 帳號在 AI Studio 建立金鑰，再依 Google 的計費方式付款。另一種是第三方 API 服務的金鑰：你向這個服務預付、拿它的金鑰，請求由它的閘道送到 Gemini。RelaySwitch 屬於後者，帳戶用一個 Email 就能開，金鑰在控制台建立，同一把金鑰還能呼叫目錄裡的其他模型。
Gemini 有自己的請求格式（generateContent），但多數現成的工具和程式是照 OpenAI 的 Chat Completions 寫的。Google 自己也提供一層 OpenAI 相容介面，並在文件裡註明這項支援仍是 beta。這裡的做法相同：價格表裡的每個 Gemini id 都能用 OpenAI 格式呼叫，所以把一段現有的 OpenAI 程式改成 Gemini，只要改 model 一個欄位。
02先用 curl 送出第一個請求
Base URL 要帶 /v1，請求走 /chat/completions，金鑰放在 Authorization: Bearer。回覆 200 代表網址、金鑰與模型 id 都正確；id 寫錯會回覆 404 model_not_found。
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gemini-3.1-pro-preview", "messages": [{"role": "user", "content": "Reply with ok"}]}'03Python：用 OpenAI SDK 呼叫 Gemini
只改 base_url、api_key 與 model 三處。串流輸出把 stream 設成 true，回應是 server-sent events，和 OpenAI 的格式相同。
如果程式原本是照 Google 的 OpenAI 相容文件寫的，它已經在用 OpenAI SDK，搬過來同樣只動這三處：網址從 Google 文件裡的位址換成 https://api.relayswitch.io/v1，金鑰從 AI Studio 的換成 sk-relay- 開頭的，模型 id 對照下方價格表核對一次。請求內容不用改；Google 文件裡透過 extra_body 傳的 Gemini 專屬欄位，本頁沒有逐項驗證，用到的話先拿一筆請求測試，再看收據上的計費是否符合預期。
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="gemini-3.1-pro-preview", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)04Gemini 各模型的即時價格
以下是目錄裡的 21 個 Gemini 模型，單位為美元／每百萬 token，表中的價格就是扣款價格。名稱帶 preview 的是預覽版，Google 之後會換成正式名稱，所以寫進程式的 id 要以表上此刻列出的為準。
Gemini 常用來讀長篇資料：整份合約、一個程式庫、一段會議錄音的逐字稿。這類請求的花費幾乎都在輸入，選模型時先看輸入單價與上下文長度，再看輸出單價。同一份資料反覆提問時，重複的部分命中快取後以快取輸入價計費，收據會把這部分 token 分開列出。計費規則見費用與價格。
| 模型 | 開發商 | 輸入 | 輸出 | 上下文長度 |
|---|---|---|---|---|
| Gemini 4 Argongemini-4-argon | $0.60≈ NT$20.17 | $3.00≈ NT$100.83 | 1,048,576 | |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925≈ NT$16.55 | $2.25≈ NT$75.62 | 1,048,576 | |
| Gemini 3.7 Flashgemini-3.7-flash | $0.4925≈ NT$16.55 | $2.25≈ NT$75.62 | 1,048,576 | |
| Gemini 3.5 Flash Litegemini-3.5-flash-lite | $0.225≈ NT$7.56 | $1.875≈ NT$63.02 | 1,048,576 | |
| Gemini 3.6 Flashgemini-3.6-flash | $0.4925≈ NT$16.55 | $2.25≈ NT$75.62 | 1,048,576 | |
| Gemini 3.5 Flashgemini-3.5-flash | $1.50≈ NT$50.41 | $9.00≈ NT$302.48 | 1,048,576 | |
| Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-preview | $0.1875≈ NT$6.30 | $1.125≈ NT$37.81 | 1,048,576 | |
| Gemini 3.1 Pro Previewgemini-3.1-pro-preview | $1.20≈ NT$40.33 | $7.20≈ NT$241.98 | 1,048,576 | |
| Gemini 3.1 PRO Preview LOWgemini-3.1-pro-preview-low | $5.00≈ NT$168.05 | $22.50≈ NT$756.20 | 1,048,576 | |
| Gemini 3 Flash Previewgemini-3-flash-preview | $0.375≈ NT$12.60 | $2.25≈ NT$75.62 | 1,048,576 | |
| Gemini 2.5 Flashgemini-2.5-flash | $0.30≈ NT$10.08 | $2.50≈ NT$84.02 | 1,048,576 | |
| Gemini 2.5 Progemini-2.5-pro | $0.9375≈ NT$31.51 | $7.50≈ NT$252.07 | 1,048,576 | |
| Gemini 2.5 Flash Litegemini-2.5-flash-lite | $0.075≈ NT$2.52 | $0.30≈ NT$10.08 | ||
| Gemini 3 Pro Previewgemini-3-pro-preview | $5.00≈ NT$168.05 | $22.50≈ NT$756.20 | ||
| Gemini 3.1 Flash Litegemini-3.1-flash-lite | $0.15≈ NT$5.04 | $0.90≈ NT$30.25 | ||
| Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtools | $4.80≈ NT$161.32 | $28.80≈ NT$967.94 | 1,048,576 | |
| Gemini 4 Carbongemini-4-carbon | $2.3529≈ NT$79.08 | $11.7647≈ NT$395.40 | ||
| Gemini 4 Hydrogengemini-4-hydrogen | $0.5882≈ NT$19.77 | $2.9412≈ NT$98.85 | ||
| Gemini Flash Latestgemini-flash-latest | $1.80≈ NT$60.50 | $9.00≈ NT$302.48 | 1,048,576 | |
| Gemini Flash Lite Latestgemini-flash-lite-latest | $0.72≈ NT$24.20 | $6.00≈ NT$201.65 | 1,048,576 | |
| Gemini PRO Latestgemini-pro-latest | $4.80≈ NT$161.32 | $28.80≈ NT$967.94 | 1,048,576 |
美元／每百萬 token · ≈ 為按 2026-11-14 各國央行參考匯率換算的新台幣參考價，實際以美元計費
05原生格式：generateContent
已經照 Google 的請求格式寫好的程式不必改寫。目錄裡支援這條路由的 Gemini id，可以把請求送到 https://api.relayswitch.io/v1beta/models/{model}:generateContent：注意網域後面直接接 /v1beta，不帶 /v1。金鑰放在 x-goog-api-key 標頭，不要寫進網址；放在查詢參數裡的金鑰會被拒絕。請求與回應都是 Google 的結構，contents 進、candidates 出。
兩種格式的錯誤也各自沿用自己的結構：OpenAI 格式的錯誤碼在 error.code；原生格式是 Google 的寫法，例如沒帶金鑰時回覆 401，error.status 為 UNAUTHENTICATED。兩種格式用同一把金鑰、同一筆餘額，價格相同。
06儲值與費用：沒有免費額度
Google 自己的 Gemini API 對部分模型有附速率限制的免費層，哪些模型在內，以它的價格頁為準。RelaySwitch 沒有免費層：每次請求按 token 從預付餘額扣款。
儲值可以用信用卡（含 Apple Pay、Google Pay）或 USDT, USDC, BTC, ETH, SOL，最低 $10；餘額以美元計，不會過期，不需訂閱，儲值不退款。從開戶到建立金鑰的步驟寫在 Claude API Key，流程完全相同。
07正式上線之前
替正式環境另外建一把金鑰，設美元預算與每日消費上限，再用模型白名單把它限定在你選定的幾個 Gemini id。讀長文件的程式尤其要設上限：一次誤把整個目錄送進去的請求，輸入就是幾十萬 token。請求失敗時，依回應標頭 retry-after 決定多久後重試。
選模型不必用猜的：所有 Gemini id 都在同一把金鑰上，同一則提示各送一次，對照回答與收據上的費用就有結論。想把 Gemini 和 GPT、Claude 放在一起比，改的也只有 model；GPT 的寫法見 OpenAI API 串接。
常見問題
- Gemini API Key 怎麼取得？需要 Google 帳號嗎？
- 不需要 Google 帳號，也不需要 AI Studio 的金鑰。帳戶開在 RelaySwitch，一個 Email 即可；儲值後在控制台建立金鑰，同一把金鑰還能呼叫目錄裡的其他模型。Google 官方的 Gemini API 金鑰，則要用 Google 帳號在 AI Studio 建立。
- Gemini API 有免費額度嗎？
- Google 自己的 Gemini API 對部分模型有附速率限制的免費層，哪些模型在內以它的價格頁為準。這裡沒有免費層：每次請求按 token 從預付餘額扣款，最低儲值 $10，餘額不會過期。
- 要用 OpenAI SDK 還是 Gemini 原生格式？
- 新寫的程式用 OpenAI SDK，改 base_url 就行，之後換其他開發商的模型也只改 model 一個欄位。已經照 Google 的 generateContent 寫好的程式，可以把請求送到原生路由，金鑰放在 x-goog-api-key 標頭。兩種格式用同一把金鑰、同一筆餘額，價格相同。
- Gemini API 的價格和 Google 官方相比如何？
- 每個模型的價格列在本頁的即時價格表，單位是美元／每百萬 token，表上的數字就是扣款價格。Google 公布的定價請看它自己的價格頁，兩邊對照之後再決定。
- Base URL 要填什麼？
- OpenAI 相容格式填 https://api.relayswitch.io/v1，要帶 /v1，SDK 會自己接上 /chat/completions。原生的 generateContent 路由則是在 https://api.relayswitch.io 後面直接接 /v1beta，不帶 /v1。
- 怎麼確認呼叫到的真的是 Gemini？
- 每個模型每天收到同一則檢查提示，回答與先前的結果比對，結果公開在 https://api.relayswitch.io/v1/proof，不需要金鑰就能查。每次請求還有一張附簽章的收據（GET https://api.relayswitch.io/v1/requests/:id/receipt），寫明模型 id、計費 token 與費用。