自訂 API 端點與 Base URL:如何連接 OpenAI 相容 API
自訂 API 端點和 Base URL(基礎網址)是什麼?只要一個網址加一把金鑰,就能連接 OpenAI 相容 API、中轉站、代理或閘道。
- 自訂 API 端點(custom API endpoint)是指 App 沒有內建的 AI 服務所用的網址,也就是 Base URL,例如 OpenAI 相容 API、中轉站(relay)、代理(proxy)或閘道(gateway)。在 Oriveo 裡,連接這類服務通常只需要兩樣東西:網址和 API 金鑰。
- Oriveo 會替你判斷協議(OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 或 Gemini),只輸入根網址時,也會自動補上 /v1 這類版本路徑。
- 公開網路上的網址必須使用 HTTPS。第三方服務看得到你經由它送出的所有內容,所以請給它一把設有消費上限的獨立金鑰,絕對不要交出你在官方供應商的金鑰。

Base URL 或 API 端點是什麼?
每個 AI 服務都有一個網址,讓 App 把請求送過去。開發者稱它為 Base URL、API 端點(API endpoint)或請求地址(request URL),在這裡指的都是同一件事。它看起來就是普通的網址,例如 OpenAI 的是 https://api.openai.com/v1。
在 Oriveo 裡,15 家內建供應商的網址都已經填好,你只要貼上金鑰。自訂端點是給其他服務用的:提供 OpenAI 相容 API 的服務、由公司營運的中轉站或閘道,或是你架在自己伺服器上的閘道。
「OpenAI 相容」(OpenAI-compatible)是指這個服務接受跟 OpenAI API 相同格式的請求,所以為 OpenAI 打造的 App 也能跟它溝通。很多供應商和閘道都提供這種格式。
中轉站、代理、閘道有什麼差別?
這幾個詞常被混著用,而就連接 App 來說,運作方式都一樣:有一個服務夾在你的 App 和模型供應商之間,接收你的請求再轉送出去。有的把好幾家供應商整合在一把金鑰、一份帳單後面;有的替團隊加上用量控管;有的是你在自己伺服器上執行的軟體。
Oriveo 不推薦、也不排名任何一家。不管你用哪一種,下面的步驟都一樣。
連接自訂端點需要準備什麼?
通常是兩樣東西,都可以在該服務的後台或文件裡找到:
- 請求地址(Base URL),例如 https://api.example.com/v1。如果服務在公開網路上,網址必須以 https:// 開頭。
- 該服務發給你的 API 金鑰。用「再加一把金鑰」可以加入更多把。
- 選填:替這條連線取個名字,方便和其他連線區分。
怎麼在 Oriveo 新增自訂端點?
iPhone、Android 和網頁版的步驟都一樣。
- 打開「供應商」,點「+」按鈕(新增供應商)。
- 選「自訂」標籤,再選「自訂中轉站」(「連線到你自己的模型服務」)。
- 在「連接自訂中轉站」頁面貼上請求地址和 API 金鑰。「將請求 …」這一行會顯示 Oriveo 實際要使用的完整網址。點「下一步」。
- Oriveo 會檢查連線、讀取模型清單,並判斷每個模型的協議。這一步只讀清單,不會送出聊天訊息。
- 勾選你要的模型,點「儲存(已選 N)」。如果服務沒有列出模型,就用「手動新增模型 ID」。
- 儲存前,Oriveo 會對第一個選取的模型送出一個很小的請求。測試通過才會儲存連線;失敗的話,你會留在同一步,可以修正後再試。

想全部自己設定?用「手動設定」
「手動設定」把所有欄位放在同一頁:網址、金鑰、模型 ID、選填的連線名稱,以及預設協議(一開始是「自動」)。點「驗證並儲存」。如果檢查失敗,這時還沒有儲存任何東西;失敗卡片上會提供「仍然儲存(未驗證)」,讓你先保留這條連線、之後再測試。
Oriveo 會自動偵測協議嗎?
大多數情況會。AI 服務使用的請求格式只有固定幾種,稱為協議(protocol)。Oriveo 支援四種:OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini generateContent。
它會逐個模型判斷。服務有提供某個模型的相關資訊時,就照著用;沒有的話,就根據模型所屬的系列挑出可能的協議。儲存時,第一個選取的模型會用真實請求測試;其他模型則在你之後開始使用時才檢查。
所以多數情況下,有網址和金鑰就夠了。如果服務的文件指定了某個協議,或某個模型沒通過檢查,請在「手動設定」裡自己選協議。
網址要加 /v1 嗎?
通常不用。如果你只輸入根網址,例如 https://api.example.com,Oriveo 會依協議補上標準的版本路徑:OpenAI 和 Anthropic 格式補 /v1,Gemini 補 /v1beta。
如果網址裡已經有版本,例如 /api/paas/v4,Oriveo 會保留。如果你貼的是以 /chat/completions、/responses、/messages 或 :generateContent 結尾的完整端點,Oriveo 會去掉這段結尾,並據此判斷服務使用哪種協議。
點「下一步」之前,先看一下「將請求 …」那一行。如果檢查結果顯示「位址可能填成了網頁,請檢查是否少了 /v1。」,請拿你的網址和服務的文件比對。
| 你輸入的網址 | Oriveo 實際請求的網址(OpenAI 格式) |
|---|---|
| https://api.example.com | https://api.example.com/v1 |
| https://api.example.com/v1 | https://api.example.com/v1 |
| https://api.example.com/v1/chat/completions | https://api.example.com/v1,使用 Chat Completions |
| https://api.example.com/api/paas/v4 | https://api.example.com/api/paas/v4 |
哪些網址可以使用?
為了保護你的金鑰,Oriveo 遵守幾條規則:
- 公開網路上的網址必須以 https:// 開頭。公開網路上的 http:// 網址無法測試,也無法儲存。
- 網址裡帶有帳號密碼,或帶有查詢參數(「?」後面的任何內容),都不接受。Oriveo 從不嘗試使用查詢參數裡的 API 金鑰。
- 家用網路或私人 VPN 上的純 http:// 網址,例如架在你自己電腦上的模型伺服器,請改走另一個「本機算力」入口(iPhone 上顯示為「本機與區域網路算力」),而不是「自訂中轉站」。
- 在 iPhone 和 Android 上,App 會直接連到這個網址。
- 在網頁版,公開網路的請求地址會經 Oriveo 伺服器轉發,以繞過瀏覽器的 CORS 限制(CORS 是一項瀏覽器安全規則,會擋下許多直接請求)。API 金鑰僅在該次請求的記憶體中使用,不寫入磁碟、不記錄。區域網路上的請求地址由你的裝置直接連線,兩種情況都需要 HTTPS;家用網路上的純 http:// 網址,則要用 iPhone 或 Android App 的「本機算力」入口。
- 金鑰只存在本機,不會隨雲端同步上傳。
內建供應商的 Base URL
在 Oriveo 裡用不到這些網址,直接按名稱選供應商就好。列出來是因為很多人會為了其他工具查詢。以下都是各供應商文件中提供的官方 OpenAI 相容網址,核對日期為 2026 年 11 月 18 日。
- Anthropic 表示它的 OpenAI 相容層是供測試和比較用的,Mistral 的快速入門文件也沒有說它的 API 與 OpenAI 相容。這兩家請改用內建供應商的方式加入。
| 供應商 | OpenAI 相容 Base URL |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
| OpenRouter | https://openrouter.ai/api/v1 |
| DeepSeek | https://api.deepseek.com |
| xAI(Grok) | https://api.x.ai/v1 |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.ai/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| MiniMax(國際版) | https://api.minimax.io/v1 |
| Z.ai(國際版) | https://api.z.ai/api/paas/v4/ |
| Qwen(新加坡區域) | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| Kimi(國際版) | https://api.moonshot.ai/v1 |
| SiliconFlow(國際版) | https://api.siliconflow.com/v1 |
使用中轉站或第三方 API 安全嗎?
請小心。任何夾在你和模型之間的服務,都能讀到你的提示詞、附加的檔案和回覆,而且價格由它自己訂。Oriveo 看不到它內部的運作,也無法替它擔保。
- 絕對不要把你官方供應商帳戶的 API 金鑰交給第三方服務。請使用該服務發給你的金鑰。
- 為 Oriveo 另建一把金鑰;如果服務允許,替它設定消費上限,或只保留少量餘額。
- 不要透過你不信任的服務傳送密碼、身分證字號或機密工作內容。
- 到該服務自己的後台查看用量。Oriveo 的費用數字是預估值;以該服務的紀錄為準。
- 金鑰外洩時,到該服務的後台刪除,再建立一把新的。
自訂端點為什麼連不上?
Oriveo 會用一句話告訴你哪裡出錯。繁體中文介面上的訊息如下:
- 401、402、429 這類代碼各代表什麼,請看我們的 API 金鑰錯誤排解指南。
| Oriveo 顯示的訊息 | 該檢查什麼 |
|---|---|
| 位址可能填成了網頁,請檢查是否少了 /v1。 | 拿網址和服務的文件比對;補上或刪掉版本路徑 |
| 金鑰無效。 | 回服務的後台重新複製金鑰 |
| 這把金鑰沒有存取模型列表的權限,可以手動新增模型。 | 在下一步自己輸入模型 ID |
| 連不上,請檢查網路或代理。 | 檢查網路連線,以及這個網址能不能連上 |
| 這個位址上的服務正在限流。 | 稍等一下再試 |
| 這條連線連不上它的上游供應商。 | 該服務在上游供應商那邊的帳戶可能已失效、credits 用完或被限流;請聯絡這項服務的營運者 |