# ZCode

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

Language: zh-TW

> 在 ZCode 中使用 aicentos —— 透過自訂 OpenAI 相容設定接入

ZCode 支援自訂的 OpenAI 相容模型設定。把 Base URL 指向 aicentos、填入 API Key，就能在 ZCode 的對話與編碼任務中使用 aicentos 接入的模型。

## 準備工作

在 aicentos 控制台建立一個專用 Key（建議命名 `zcode`，方便追蹤用量）。

## 需要填寫的設定

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

## 設定步驟

* 開啟 ZCode 設定，進入模型 / AI 設定區域。
* 找到 Provider 相關選項，選擇 **OpenAI Compatible**（或「自訂 OpenAI」）。
* 填入在 aicentos 控制台建立的 API Key。
* 把 Base URL 設為：`https://aicentos.com/v1`
* 填入模型 ID（參考[支援的模型](https://docs.aicentos.com/zh-TW/billing/models-list)）；下拉選單沒有目標模型時直接手動輸入。
* 儲存設定，如提供 **Verify** 按鈕則先點一次。

## 測試

新建一個對話或編碼任務，發一句簡單提示詞，確認能正常回傳內容。

## 注意事項

* Base URL 只填到 `/v1`，不要補成完整的 `/chat/completions` 或 `/v1/responses` 路徑。
* 如果目前版本只能選擇官方內建模型、沒有可編輯的 Base URL，則不能直接接入此閘道，此時只能改用支援自訂端點的用戶端。
* 建議先用 `GET /v1/models` 確認可見模型，再回到 ZCode 裡填寫 Model ID。
* 帳戶餘額不足時請求會失敗，先到[錢包頁](https://aicentos.com/wallet)確認餘額。