自訂端點與 Base URL

自訂 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。第三方服務看得到你經由它送出的所有內容,所以請給它一把設有消費上限的獨立金鑰,絕對不要交出你在官方供應商的金鑰。
iPhone 上的 Oriveo:供應商頁面,列出你已連接的供應商和本月花費。

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 會對第一個選取的模型送出一個很小的請求。測試通過才會儲存連線;失敗的話,你會留在同一步,可以修正後再試。
iPhone 版 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。」,請拿你的網址和服務的文件比對。

網址要加 /v1 嗎?
你輸入的網址Oriveo 實際請求的網址(OpenAI 格式)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1,使用 Chat Completions
https://api.example.com/api/paas/v4https://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 相容。這兩家請改用內建供應商的方式加入。
內建供應商的 Base URL
供應商OpenAI 相容 Base URL
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI(Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://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 用完或被限流;請聯絡這項服務的營運者

App 常見問題

什麼是自訂 API 端點?
就是 App 沒有內建的 AI 服務所用的網址,例如 OpenAI 相容 API、中轉站或閘道。輸入這個網址(Base URL)和該服務給你的 API 金鑰,就能連接。
什麼是 OpenAI 相容 API?
指接受跟 OpenAI 相同格式請求的 API,所以為 OpenAI 打造的 App 也能使用。很多供應商和閘道都有提供,網址通常以 /v1 結尾。
Base URL 要填什麼?
填服務文件裡寫的那個。如果文件只給了網域,就輸入網域,Oriveo 會補上 /v1(Gemini 格式則補 /v1beta)。繼續之前,先看一下「將請求 …」那一行。
iPhone 和 Android 可以用自訂端點嗎?
可以。iPhone、Android 版 Oriveo 和網頁版都有「自訂中轉站」。在 iPhone 和 Android 上,App 會直接連到這個網址。
Oriveo 為什麼要求 HTTPS?
HTTPS 會加密連線,你的金鑰和訊息就不會以明文在網路上傳送。如果是家用網路上的模型伺服器,請用「本機算力」入口。
使用 API 中轉站或代理安全嗎?
它能讀到你經由它送出的所有內容,所以信任很重要。請使用該服務給你的金鑰,絕對不要用官方供應商的金鑰;設定消費上限,也別讓敏感資訊經過它。

延伸閱讀

來自部落格

連接你自己的模型服務

打開網頁版,或下載 iPhone、Android 版 Oriveo,選「自訂中轉站」,貼上服務提供的網址和金鑰。

還沒有 API 金鑰?先用 Oriveo Free 免費開始也可以。