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 KeyStandard API Keyの作成画面残高または対象の利用パッケージ。Coding Plan枠ではない
個人Coding Plan API KeyPersonal Coding Plan個人プランの利用枠
Team Plan KeyTeam 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/v4Coding Plan Chat Completions過去にプランを持ったアカウントはプラン枠を使用。期限切れで呼び出し停止
https://api.z.ai/api/anthropicAnthropic Messages公式Compatible表と同じ契約履歴の規則
https://api.z.ai/api/v1OpenAI 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時と推測しない
1309Coding 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が返ったら、必ず待って再試行すべきですか?
いいえ。事業者の業務エラーコードは、残高、利用枠、プラン期限、モデル利用権、レート制限などを示します。明示された原因を直してから再試行を判断してください。