GLM Coding Planの枠があるのに残高が減るのはなぜ?キーと429を確認
Standard・Coding Plan・旧Compatibleキーの違いからGLMの課金先を追跡。利用枠、期限切れ、モデル権限、レート制限を切り分けます。
GLM Coding Planを契約していても、アカウント内のすべてのキーがプラン枠を使うわけではありません。 2026年10月16日以降に作成したStandardとCoding Planのキーは、対応エンドポイント全体でキーの種類が課金を決めるとZ.aiは説明しています。旧 Compatible キーには、エンドポイントに依存する別の規則があります。
この違いにより、「まだプラン枠がある」状態で残高が引かれたりリクエストが失敗したりします。本記事では、経路とキーの確認表、エラー分類器、条件を揃えた検証手順を示します。2026年11月17日に確認した公式文書に基づき、有料の課金実験や読者のアカウント調査は行っていません。
本記事はGLMの使い方に関する記事群を補うもので、GLM 5.5の発表ではありません。本日確認した公式の公開索引には引き続きGLM-5.3系が掲載されています。その確認はGLM 5.5のリリースと提供状況を参照してください。動いている設定に推測した glm-5.5 を入れないでください。
コンソールでキーの種類を特定する
Z.aiのAPIキー管理ガイド(英語)に従い、実際のツールプロセスに設定されているキーを確認します。秘密の文字列の見た目ではなく、コンソールのラベルと作成元を調べてください。1つのアカウントに複数種類のキーが存在する場合があります。
| コンソール上の種類 | 取得元 | 調べる課金規則 |
|---|---|---|
| Standard API Key | Standard API Keyの作成画面 | 残高または対象の利用パッケージ。Coding Plan枠ではない |
| 個人Coding Plan API Key | Personal Coding Plan | 個人プランの利用枠 |
| Team Plan Key | Team Coding Plan → My Plan | チームと席の規則。設定済みの超過利用方針も含む |
| 旧Compatibleキー | 過去のキーを自動分類 | エンドポイントと過去のプラン契約状況で決まる |
10月16日の通知は、分類変更だけを理由に既存のキー値を交換する必要はないとしています。Team Planプロジェクトの旧キーはTeam Planキーに分類されます。チーム外で、過去にCoding Planを持ったアカウントの対象個人キーはCompatibleになります。契約履歴のない旧アカウントではStandard分類です。専用企業サービスやパートナーチャネルの例外は、契約上の従来の動作を維持する場合があります。
最初からすべてのキーを交換しないでください。まず実際に使われているものを特定します。ターミナルの環境変数、IDE設定、プロジェクト設定、プロバイダー切替ツールが古い資格情報を参照している可能性があります。調査メモには秘密ではないコンソール名や内部識別子だけを記録し、キー全体を問い合わせや公開画像に貼らないでください。
種類に応じたエンドポイント規則を適用する
新しいStandardとCoding Planキーでは、対応エンドポイント間を移動しても課金種別は変わりません。Claude CodeでStandardキーを使うと、有効なCoding Planに枠が残っていてもAPI残高から課金される場合があります。プラン枠を使うには、該当するプランキーと対応ツール設定を使います。
旧Compatibleキーについて、Z.aiの通知は次の動作を示しています。
| Base URL | プロトコル・用途 | Compatibleキーの動作 |
|---|---|---|
https://api.z.ai/api/paas/v4 | 標準Chat Completions | 残高または対象利用パッケージ。Coding Plan枠は使わない |
https://api.z.ai/api/coding/paas/v4 | Coding Plan Chat Completions | 過去にプランを持ったアカウントはプラン枠を使用。期限切れで呼び出し停止 |
https://api.z.ai/api/anthropic | Anthropic Messages | 公式Compatible表と同じ契約履歴の規則 |
https://api.z.ai/api/v1 | OpenAI Responses | 公式Compatible表と同じ契約履歴の規則 |
通知は、Coding Planの契約履歴がないアカウントでは後ろの3経路も残高またはパッケージ課金になると説明しています。コンソール上の分類がこの状況に合わない場合、URLだけから推測せず、サポートに分類とリクエスト記録の照合を依頼してください。チームの超過利用や専用企業契約はアカウント固有の確認が必要です。
これらはZ.aiの経路であり、中国向けBigModelや第三者の課金規則ではありません。OfoxキーはOfoxの認証仕様に従い、Z.aiの契約を引き継ぎません。切替前にOfoxのモデル提供状況と対象プロバイダーの文書を確認し、表のURLをOfox設定へコピーしないでください。
1回のリクエストを使用量記録まで追跡する
変更前に小さな確認表を作ります。
Client and version:
Process actually launched (CLI / IDE / container):
Provider and Base URL:
Protocol (Messages / Chat Completions / Responses):
Exact model ID or alias mapping:
Key class shown in provider console (NO secret value):
Plan active? Remaining quota? Team overage enabled?:
Local timestamp and time zone:
HTTP status / business code / sanitized request ID:
Usage record and billing bucket after the test:
記録するのは、クライアントとバージョン、実際の起動プロセス、接続先とBase URL、プロトコル、モデルIDや別名の割り当て、コンソールのキー種別(秘密の値は除外)、プランと超過利用の状態、現地日時とタイムゾーン、HTTPステータスと機密情報を除いたID、テスト後の使用量・課金先です。
比較を混乱させないよう、無関係なテストセッションを止めます。対象のプラン使用量と残高画面を記録し、費用が発生し得ることを了承できる場合だけ、小さく機密性のないリクエストを1回送ります。例えば、ツールやリポジトリを使わず READY だけ返すよう依頼します。これは基本的な呼び出しの確認で、品質ベンチマークではありません。
続いてクライアントの時刻、取得できるリクエストID、選択モデル、プロバイダーの使用量記録を照合します。応答が成功しただけでは、どの枠から支払われたかは分かりません。ダッシュボードの集計遅延も考慮します。それでも帰属が不明なら実験を止め、機密情報を除いた証拠をサポート用に保存してください。有料の試行を連続させないようにします。
次は説明用の例であり、測定結果ではありません。
- 新StandardキーでClaude Codeの呼び出しが成功し、標準APIの使用量へ記録された。プラン枠が残っていても文書の規則と整合します。
- 旧Compatibleキーが標準Chat Completionsで成功し、残高が引かれた。この旧キーでは経路だけの変更で課金先が変わり得ますが、新Standardキーには一般化できません。
- 期限切れプランのCompatibleキーがプラン経路で失敗した。通知では従量課金へ自動移行しないとしています。API課金を選ぶならStandardキーを作り、対応エンドポイントと十分な残高で利用します。これは課金の選択であり、無料の代替ではありません。
新しいキーの場合、正しい種類に交換して実際のクライアントプロセスを再起動し、条件を揃えてもう1回確認します。Compatibleキーなら先にプランか標準APIかを決め、文書の規則を適用します。キー、エンドポイント、モデル、再試行方針を同時に変えると、どの変更が効いたか分からなくなります。
429の中にある業務エラーコードを読む
Z.aiのエラーコード一覧(英語)では複数の原因にHTTP 429が割り当てられています。一般的な指数バックオフですべて解決できるわけではありません。
| コード | 文書上の分類 | 対処 |
|---|---|---|
1113 | 残高・リソースパッケージ不足 | 課金先と資金を確認。プラン枠が使えると決めつけない |
1302 | リクエストのレート制限 | 並列数を下げ、上限付きのバックオフを使う |
1305 | 一時的な過負荷 | 回数を制限して再試行し、継続失敗を記録 |
1308、1310 | 利用期間ごとの上限 | 返されたリセット情報を読む。現地の午前0時と推測しない |
1309 | Coding Plan期限切れ | 状態を確認し、承認された更新か意図した標準API利用を選ぶ |
1311 | 選択モデルをプランが含まない | モデル利用権と正確な割り当てを確認 |
1313 | 公正利用の制限 | 公式サポート手順に従う。キーを増やしても回避策にはならない |
1315 | 企業向けコーディング用途に限定されたキー | 適切な製品キーとアカウント設定を使う |
1316–1321 | 利用期間の上限と追加利用残高・支出上限の条件 | 正確なメッセージを読み、支出を変える前に超過利用資格と設定上限を確認 |
認証エラーは別の分岐です。例えば文書の 1000、1001 はHTTP 401に対応します。枠を増やしても認証ヘッダーの欠落は直りません。逆に、有効なキーを繰り返し交換しても期限切れのプランは復旧しません。
保存済みのエラーレスポンスをローカルで分類するには、次を classify_glm_error.py として保存します。標準入力からJSONを読み、コードと診断カテゴリだけを表示します。応答メッセージや資格情報は表示しません。
import json
import sys
categories = {
"1000": "authentication", "1001": "authentication",
"1003": "authentication", "1005": "authentication",
"1113": "billing-balance", "1302": "request-rate",
"1305": "temporary-overload", "1308": "usage-window",
"1309": "plan-expired", "1310": "usage-window",
"1311": "model-entitlement", "1313": "fair-usage",
"1314": "enterprise-plan-expired", "1315": "key-product-mismatch",
}
categories.update({str(n): "extra-usage-condition" for n in range(1316, 1322)})
data = json.load(sys.stdin)
error = data.get("error", {}) if isinstance(data, dict) else {}
code = str(error.get("code", "unknown")) if isinstance(error, dict) else "unknown"
print(json.dumps({"code": code, "category": categories.get(code, "inspect-provider-response")}))
ローカルの合成データで確認します。
printf '%s\n' '{"error":{"code":"1311","message":"synthetic example"}}' | python3 classify_glm_error.py
期待されるカテゴリは model-entitlement です。分類器は数値コードやerrorオブジェクトの欠落も含めてローカルテストしました。ネットワーク障害を診断したり、ゲートウェイ固有の形式を変換したり、実際のメッセージ確認を代行したりはしません。不明という結果は応答構造を調べる合図で、成功を意味しません。SSEストリームの途中で異常終了した場合、Z.aiは通常のエラーコードではなく finish_reason に理由を示すと説明しています。ストリームイベントを別途保存・確認してください。このJSON分類器はSSEを解析しません。
課金を直した後でモデル選択を確認する
キーと経路が正しくなったら、正確なモデル割り当てを別に検証します。公式のモデル切替ガイド(英語)には現在GLM-5.3とGLM-5.3-Flashが記載されています。契約の階層、Opusなどのクライアント別名、公開APIのモデルIDはそれぞれ別物です。
モデルが見つからない場合、設定したIDとプロトコルを現在の文書と比べます。OpenAIのmodel-not-found対処ガイド(英語)のプロバイダー・エンドポイント・権限を確認する方法は参考になりますが、GLM固有のエラー再現記録ではありません。Ofox経路のリクエスト調整はOfoxのレート制限文書を参照してください。その制限をZ.aiアカウントにそのまま当てはめないでください。
プランの動作確認に推測上のGLM 5.5を使わず、アカウントと経路で明示的に利用可能なモデルから始めます。基本呼び出しと課金帰属を確認してから、長いエージェント処理、ツール、コンテキスト拡張を試してください。
再試行を増やすのではなく証拠を揃えて解決する
解決記録では、キーの種類、意図したエンドポイント、受け付けられたモデル、実際の課金先を特定し、修正後に対象エラーが止まったことを示します。秘密情報を作り直さず設定を戻せるよう、以前の設定を保持してください。
プロバイダーの記録が文書の規則と食い違う場合、タイムゾーン付き日時、機密情報を除いたリクエストID、キー種別、モデル、エラーコードをサポートへ渡します。別途承認された理由と安全な経路がない限り、キー全体や私的なプロンプト内容は送らないでください。これにより、不確かなリクエストをさらに増やさずに課金を調査できます。
よくある質問
- Base URLを変えると新しいStandardキーでCoding Planの枠を使えますか?
- いいえ。Z.aiによると、2026年10月16日以降に作成したStandardとCoding Planのキーは、対応エンドポイント全体でキーの種類が課金を決めます。旧Compatibleキーには別の規則があります。
- GLMでHTTP 429が返ったら、必ず待って再試行すべきですか?
- いいえ。事業者の業務エラーコードは、残高、利用枠、プラン期限、モデル利用権、レート制限などを示します。明示された原因を直してから再試行を判断してください。


