# ZCode

出典: https://docs.aicentos.com/ja/clients/zcode

Language: ja

> ZCode で aicentos を使う —— カスタム OpenAI 互換設定による接続

ZCode はカスタムの OpenAI 互換モデル設定に対応しています。Base URL を aicentos に向けて API Key を入力すれば、ZCode の会話やコーディングタスクで aicentos に接続されたモデルを利用できます。

## 準備

aicentos コンソールで専用のキーを 1 つ作成します（名前は `zcode` のようにすると使用量の追跡に便利です）。

## 設定値

| 項目       | 値                         |
| -------- | ------------------------- |
| Provider | `OpenAI Compatible`       |
| API 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/ja/billing/models-list) を参考にできます）。ドロップダウンに目的のモデルがない場合は、直接手入力します。
* 設定を保存します。**Verify** ボタンがある場合は、先に 1 回クリックします。

## テスト

新しい会話またはコーディングタスクを作成し、簡単なプロンプトを 1 つ送って、正常に内容が返ることを確認します。

## 注意事項

* Base URL は `/v1` まで入力し、完全な `/chat/completions` や `/v1/responses` パスに補わないでください。
* 現在のバージョンが公式内蔵モデルしか選べず、編集可能な Base URL がない場合は、このゲートウェイに直接接続できません。その場合は、カスタムエンドポイントに対応したクライアントに変更するしかありません。
* まず `GET /v1/models` で見えるモデルを確認してから、ZCode に戻って Model ID を入力することをおすすめします。
* アカウントの残高が不足しているとリクエストは失敗します。先に[ウォレットページ](https://aicentos.com/wallet)で残高を確認してください。