# Orca

來源: https://docs.aicentos.com/zh-TW/clients/orca

Language: zh-TW

> 在 Orca 中使用 aicentos —— 新增 OpenAI 相容自訂端點

Orca 支援設定自訂的 OpenAI 相容服務。把 Base URL 指向 aicentos、填入 API Key，即可在 Orca 中使用 aicentos 接入的模型。

## 準備工作

先在控制台「API Key」頁面為 Orca 建立一個專用 Key（建議命名 `orca`，方便追蹤用量）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)
* 文件站：[https://docs.aicentos.com](https://docs.aicentos.com)

## 需要填寫的設定

| 欄位          | 值                         |
| ----------- | ------------------------- |
| Provider 類型 | OpenAI Compatible         |
| Base URL    | `https://aicentos.com/v1` |
| API Key     | 控制台建立的 Key                |
| Model       | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

* 開啟 Orca 的設定頁面，進入模型 / Provider 設定區域。
* 新增一個 provider，類型選擇 OpenAI 相容（OpenAI Compatible / Custom OpenAI）。
* Base URL 填：`https://aicentos.com/v1`
* API Key 填控制台建立的 Key。
* Model 填控制台「模型廣場」中的模型名稱（參考 [支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list)）。
* 儲存並設為預設模型。

## 測試

新建一個對話傳送一句簡單提示詞，確認能正常回應。若模型下拉選單為空，改為手動輸入 Model ID。

## 注意事項

* Base URL 只填到 `/v1`，不要補成 `/v1/chat/completions` 完整路徑。
* 儲存後如果設定沒有立即生效，重新啟動一次 Orca。
* 若你的 Orca 版本只支援內建的官方 provider、沒有自訂 Base URL 入口，則該版本無法接入第三方端點，請改用其他支援自訂 Base URL 的用戶端。
* 常見的連線失敗原因：Base URL 寫錯、Key 有前後空格、模型名稱不存在、帳戶餘額不足。