> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Z.AI (GLM Coding Plan) - サブスクリプションベースの推論

> GLM Coding Plan サブスクリプションを含む、Z.AI の GLM モデルを Kodus に接続する方法を学びます。

## Z.AI の動作方法

Z.AI（Zhipu AI によって開発）は GLM ファミリーのモデルを提供します。API アクセスに**定額サブスクリプション**を提供している数少ない主要プロバイダーの1つです：**GLM Coding Plan** は、トークンごとの課金ではなく5時間および週次ウィンドウに適用されるレート制限で、固定月額料金でモデル使用量をバンドルします。

より大量または変動するワークロードには、Z.AI は標準 Developer API で同じモデルへのペイパートークンアクセスも提供しています。

両方のパスは OpenAI 互換エンドポイントを公開しているため、Kodus は **OpenAI-compatible** プロバイダーを通じて通信できます。Kodus には専用の **Z.ai** プロバイダーもあり、Z.AI の Anthropic 互換エンドポイント（`https://api.z.ai/api/anthropic`）経由で接続します。

## プランの概要

> [!NOTE]
>
> 価格とクォータは定期的に変更されます。ティアを選択する前に、[z.ai/subscribe](https://z.ai/subscribe) と [docs.z.ai](https://docs.z.ai/devpack/overview) で最新の数値を必ず確認してください。

### GLM Coding Plan（サブスクリプション）

| ティア | 価格（月額換算） | API バリュー換算の概算 | 同時実行数 |
| - | - | - | - |
| **Lite** | 約\$18/月（四半期課金） | 月額料金の約15倍 | 約1 concurrent |
| **Pro** | 約\$30/月（四半期課金） | 月額料金の約20倍 | 約1 concurrent |
| **Max** | 約\$80/月（四半期課金） | 月額料金の約30倍 | 最大30 concurrent |

* クォータはローリング**5時間**ウィンドウと**週次**ウィンドウでリセットされます — 月次上限ではなくその上限を念頭に計画してください。
* カバレッジには GLM-5.1、GLM-5-Turbo、GLM-5、GLM-4.5、GLM-4.5-Air が含まれます。
* Coding Plan のエンドポイント：`https://api.z.ai/api/anthropic`（Anthropic 互換 — Kodus の **Z.ai** プロバイダーが使用するもの）と `https://api.z.ai/api/coding/paas/v4`（OpenAI 互換）。標準の `/api/paas/v4/` エンドポイントは Coding Plan を消費しません。

### ペイパートークン Developer API

| モデル | 価格（入力/出力トークン 100万当たり） | コンテキストウィンドウ |
| - | - | - |
| **GLM-5.1** `推奨` | $0.95 / $3.15 | 約200kトークン |
| **GLM-5** | $0.72 / $2.30 | 約131kトークン |
| **GLM-4.5** | $0.60 / $2.20 | 約128kトークン |
| **GLM-4.5-Air** | より低い価格帯、ルーティング最適化 | 約128kトークン |

標準エンドポイント：`https://api.z.ai/api/paas/v4/`（OpenAI 互換）。

## APIキーの作成

> [!WARNING]
>
> APIキーを作成するには Z.AI アカウントが必要です。

**Coding Plan サブスクライバー**

1. [z.ai](https://z.ai) にサインインします。
2. [z.ai/subscribe](https://z.ai/subscribe) で **GLM Coding Plan** ティアを購入します。
3. サブスクリプションのキー管理ページを開き、Coding Plan キーを作成します。
4. キーをコピーします — 再度見ることはできません。

> [!NOTE]
>
> Coding Plan キーは Coding Plan のエンドポイント（`/api/anthropic` と `/api/coding/paas/v4`）に紐づいています。標準の `/api/paas/v4/` エンドポイントに対して送信すると**401 を返します**。

**Developer API（ペイパートークン）**

1. [z.ai](https://z.ai) にサインインします。
2. [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list) で **API Keys** セクションを開きます。
3. **Create API Key** をクリックし、説明的な名前（例：`kodus-prod`）を付けてキーをコピーします。

> [!NOTE]
>
> Developer API キーは `/api/paas/v4/` エンドポイントに紐づいています。

## Kodus で Z.AI を設定する

主なフローは Kodus Cloud の **AI providers** ページです。プロセスレベルでプロバイダーを固定することを好むセルフホストユーザーは、代わりに環境変数を使用できます。

### オプション1 — Kodus Cloud の Z.ai プロバイダー（推奨）

**1. AI providers を開き Z.ai を選択**

サイドバーで **AI providers** を開きます（[app.kodus.io/byok](https://app.kodus.io/byok)）。**Providers** タブで **Z.ai** タイルをクリックします（**Connect your first provider** の下、またはすでにプロバイダーを接続している場合は **Add another provider** の下）。

**2. APIキーを貼り付けてモデルを入力**

Z.AI キーを **API key** カードに貼り付け、**Model** にモデル ID（例：`glm-5.1`）を入力します。Kodus は `https://api.z.ai/api/anthropic` エンドポイント（Z.AI が GLM Coding Plan 向けに文書化している Anthropic 互換エンドポイント）を自動で入力するため、このタイルにはプランセレクターもベース URL フィールドもありません。特定の OpenAI 互換エンドポイントを使用したい場合は、下記のオプション2を使用してください。

**3. 同時実行数を設定（Coding Plan）**

Kodus は同時実行数を事前入力しません。Coding Plan Lite/Pro では、**Advanced (optional)** を開いて **Max concurrent requests** を `1` に設定します。Max ティアの場合は最大 30 まで上げてください。

**4. Test & save**

**Test & save** をクリックします。Kodus は接続をテストし、成功時に設定を保存します。401 はキーがエンドポイントと一致しないことを意味します。

### Reasoning のチューニング（任意）

**Thinking / Reasoning** は **Advanced (optional)** の下にあります。GLM では、Off 以外のレベルはすべて `thinking: { type: "enabled" }` を生成し、ほとんどのワークロードではこれで問題ありません。オーバーライドする2つのケース：

* **特定のトークン予算を強制** — **Thinking / Reasoning** を **Custom** に切り替え、以下を貼り付け：

  ```json theme={null}
  {
    "thinking": { "type": "enabled", "budget_tokens": 20000 }
  }
  ```

* **thinking を無効化** — 小さな PR で最速/最安のレビューのために：

  ```json theme={null}
  {
    "thinking": { "type": "disabled" }
  }
  ```

> [!NOTE]
>
> 名前空間のラップは不要です — Kodus が送信前にオプションをアクティブなプロバイダーの名前空間でラップします。詳しくは [main BYOK doc → Custom JSON override](https://docs.kodus.io/ja/how_to_use/byok.md#カスタム-json-オーバーライド) を参照してください。

### 同時実行数のチューニング

* **Coding Plan Lite / Pro**：**Max concurrent requests** を `1` に設定します。それ以上にすると `429 Too much concurrency` を返します。
* **Coding Plan Max**：最初に `5` に上げ、429 が発生しなければ最大 `30` まで。Max ティアは最大30 concurrent を許可します。
* **Developer API**：空のまま開始（制限なし）。レート制限エラーが発生したら `5` に下げ、その後調整します。

> [!NOTE]
>
> **Routing** タブで GLM 5.1 を **Model for all tasks** に、OpenAI または Anthropic のモデルを **Fallback (optional)** に設定することで、Coding Plan の5時間ウィンドウが枯渇してもレビューが継続されます。Kodus は自動的にフェイルオーバーします。

### オプション2 — OpenAI 互換エンドポイント

Z.AI の OpenAI 互換エンドポイントのいずれかを通じて接続するには、**AI providers** を開き、**Providers** タブの **Custom** の下にある **OpenAI-compatible** を選択して以下を入力します：

| フィールド | 値 |
| - | - |
| **ベース URL** | `https://api.z.ai/api/coding/paas/v4`（Coding Plan） `https://api.z.ai/api/paas/v4/`（Developer API） |
| **モデル** | `glm-5.1`、`glm-5`、`glm-5-turbo`、`glm-4.5`、`glm-4.5-air` |
| **API key** | Z.AI キー（上記のベース URL と一致） |
| **Max concurrent requests**（**Advanced (optional)** の下） | Lite/Pro Coding Plan では `1`；Max では最大 `30`；Developer API では空のまま |

### オプション3 — セルフホスト（環境変数）

固定モード（単一グローバルプロバイダー、組織ごとの BYOK なし）で Kodus を実行している場合は、API とワーカーコンテナの `.env` で Z.AI を設定します：

```env theme={null}
# Z.AI configuration (Fixed Mode)
API_LLM_PROVIDER_MODEL="glm-5.1"                                  # any GLM model you have access to
API_OPENAI_FORCE_BASE_URL="https://api.z.ai/api/coding/paas/v4"   # use /api/paas/v4/ for pay-per-token
API_OPEN_AI_API_KEY="your-z-ai-api-key"
```

> [!NOTE]
>
> このパスは意図的に BYOK を無効にしているセルフホスト Kodus インストールにのみ必要です。セルフホストインスタンスで BYOK が有効な場合は、**オプション1**を優先してください — **AI providers** ページはクラウドと同じように動作します。

`.env` を編集後、API とワーカーコンテナを再起動して統合を確認します：

```bash theme={null}
docker-compose logs api worker | grep -iE "z\.ai|glm"
```

完全なセルフホストセットアップ（ドメイン、セキュリティキー、データベース、Webhook、リバースプロキシ）については、[汎用VMデプロイガイド](https://docs.kodus.io/ja/how_to_deploy/deploy_kodus/generic_vm.md) に従い、LLM ブロックのみ上記のものと置き換えてください。

## Coding Plan とペイパートークンの選択

* 予測可能なレビュアーチームがあり、定額月額コストを希望する場合は **Coding Plan** を選択します。5時間および週次クォータは、サブスクリプション料金に対して約15〜30倍の同等 API 支出に相当します。
* トラフィックがバースト的な場合、最大コンテキストウィンドウへの不定期アクセスが必要な場合、または PR ボリュームに応じてコストを線形にスケールしたい場合は**ペイパートークン**を選択します。
* **ペアにする**：**Routing** で Coding Plan を **Model for all tasks** として使用し、サブスクリプションウィンドウを枯渇させるバーストをカバーするため、Developer API キー（または完全に異なるプロバイダー）を **Fallback (optional)** として使用します。

## トラブルシューティング

> **Test 後の 401 — キーがエンドポイントと一致しない**
>
> * Coding Plan キーは `/api/anthropic` と `/api/coding/paas/v4` で動作し、`/api/paas/v4/` では動作しません。Developer API キーは `/api/paas/v4/` を使用します。
> * **Z.ai** タイルは常に `https://api.z.ai/api/anthropic` を使用します。キーが別のエンドポイントでのみ有効な場合は、その **Base URL** を指定して **OpenAI-compatible** 経由で接続してください。
> * **OpenAI-compatible** では、**Base URL** がキーの出所と一致することを確認してください。

> **レビュー時の 'Too much concurrency'**
>
> * Lite および Pro Coding Plan ティアは通常、**1 concurrent リクエスト**のみを許可します。**Max concurrent requests** を `1` に設定し、Max でのみ上げてください。
> * まだ 429 にヒットしている場合は、Advanced settings で **Max concurrent requests** を下げます。

> **Coding Plan でクォータ枯渇**
>
> * クォータは**5時間ローリングウィンドウ**と**週次ウィンドウ**で適用されます。どちらかに達すると HTTP 429 を返します。
> * Z.AI コンソールで残りのクォータを確認します。
> * オプション：次のウィンドウを待つ、より高いティアにアップグレードする、またはギャップをカバーするために Developer API キーを **Routing** の **Fallback (optional)** モデルとして設定する。

> **モデルが見つからない**
>
> * モデル ID が Z.AI のカタログと一致していることを確認します（`glm-5.1`、`glm-5-turbo`、`glm-5`、`glm-4.5`、`glm-4.5-air`）。
> * Coding Plan は現在 GLM ファミリーのみをカバーしています — GLM 以外のモデル名は拒否されます。

> **接続エラー（タイムアウト、DNS）**
>
> * サーバーが `api.z.ai` に到達できることを確認します。
> * API とワーカーのログで正確な上流エラーを確認します。
> * アウトバウンドトラフィックが制限されているリージョンにいる場合は、インフラが許可するリバースプロキシを通じてリクエストをルーティングします。

## 関連リンク

* [GLM Coding Plan（価格）](https://z.ai/subscribe)
* [Z.AI 開発者ドキュメント](https://docs.z.ai/devpack/overview)
* [BYOK の概要](https://docs.kodus.io/ja/how_to_use/byok.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.