中国国内のチームにとって、GLM API の現実的な利点は公式サービスが国内にあることです。越境ネットワークや海外決済のために別の方式を設計する必要はありません。ただし「アクセスできる」は「安定して本番運用できる」と同じではありません。実際の安定性は、DNS、TLS、同時実行、レート制限、リトライ、請求、障害切り替えといったエンジニアリングの細部で決まります。

本記事では、公式直結と API ゲートウェイ経由の 2 方式を比較し、ネットワーク調査の方法、容量計画の考え方、公開前の検証チェックリストを示します。結論は決め打ちしません。単一モデルを深く使う場合と、複数モデルを統合接続する場合では、適した選択が異なります。

注記：智谱、GLM、BigModel は関連する権利者の商標です。本記事は技術的な説明のみを目的とし、智谱との提携・代理関係はありません。エンドポイント、レート制限規則、サービス規約は、智谱開放プラットフォームの公式ドキュメントおよびゲートウェイ管理画面を基準とします。

一、直結が向く状況

直結とは、業務から智谱の公式インターフェースへ直接リクエストする方式です。次のようなチームに向いています。GLM シリーズのみを使う。新しいモデルとパラメータをいち早く入手したい。監視とリトライの仕組みがすでに整っている。財務が公式と直接決済できる。

直結の利点は経路が短く、責任の境界が明確なことです。問題が起きたとき、呼び出しチェーンは業務、ネットワーク、公式サービスの 3 段だけなので、調査範囲が狭くなります。新しい能力は通常まず公式インターフェースで公開されるため、直結は早期検証にも向いています。

直結の代償は単一依存です。アカウント単位のレート制限、残高不足、プラットフォームの混雑が業務に直接影響します。マルチモデル戦略では、チームが複数のキー、複数の Base URL、複数の請求を管理する必要があります。小規模チームでは、この管理コストが見落とされがちです。

二、ゲートウェイが補う能力

API ゲートウェイは複数のモデル提供者を 1 つの OpenAI 互換入口に集約します。一般的な価値は 4 点です。Base URL の統一、キーの統一、残高と請求の統一、監視の統一。GLM、DeepSeek、Claude などを同時に使うチームでは、業務コードが提供者ごとのアダプターを書く必要がなくなります。

ZSQH AI Gateway に登録すると、1 つのキーで開通済みのモデルを呼び出せます。具体的なモデル範囲と課金方式はモデル価格ページで確認してください。自動障害切り替えに対応するか、切り替え順序をどう設定するかは、ゲートウェイの現行能力によります。接続前に管理画面またはサポートへ確認し、「ゲートウェイがあれば自動的に高可用になる」と決めつけないでください。

ゲートウェイは新たな依存も生みます。ネットワークホップが 1 つ増え、レート制限の層が 1 つ増え、監視すべきサービスが 1 つ増えます。選ぶ理由は管理コストの削減であり、すべての障害をなくせるからではありません。

三、ネットワーク問題の特定方法

まず「ネットワーク問題」を 4 層に分けます。DNS 解決、TCP 接続、TLS ハンドシェイク、HTTP 応答です。curl -v で各段階の所要時間と状態を確認できます。以下は最小の診断コマンドです。

curl -v --connect-timeout 5 --max-time 30 \
  https://open.bigmodel.cn/api/paas/v4/chat/completions \
  -H "Authorization: Bearer $GLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'

重点的に見る指標は 3 つです。time_namelookup が異常なら DNS の問題、time_appconnect が長すぎれば TLS または経路の問題、time_starttransfer が想定を大きく超えればサーバー側の待ち行列またはネットワーク混雑です。1234 のようなネットワーク異常とエラー ID が返る場合は、リクエスト時刻と ID を保持し、プラットフォーム側の調査に備えます。

本番環境では、プロキシ環境変数、コンテナの DNS、コネクションプールの上限、Keep-Alive 設定も確認します。多くの「偶発的なタイムアウト」は提供者の問題ではなく、クライアントのコネクションプール枯渇やプロキシ設定の不整合によるものです。

四、レート制限と容量計画

智谱の公式ドキュメントによると、レート制限は主に同時リクエスト数で判断され、モデルごとに上限が独立し、アカウント単位で適用されます。アカウント制限を超えると 1302、プラットフォーム全体の混雑時は 1305、割当上限到達時は 1308 が返る可能性があります。3 者の対応は異なります。1302 は同時実行を下げるかキューイング、1305 はバックオフしてリトライ、1308 は割当の調整または更新待ちです。

容量計画では平均値だけを見ないでください。ピーク同時実行で設計し、リトライと突発分の余裕を確保します。キューでピークを削り、定刻タスクが一斉に上限を打たないようにします。オフライン処理は Batch または非同期インターフェースに回し、オンライン同時実行をリアルタイムリクエストに残します。より高い上限が必要な場合、公式管理画面からレート制限の調整申請が可能です。審査期間はプラットフォームの説明を基準とします。

方式 ネットワーク経路 モデル範囲 レート制限と障害 向く場面
公式直結 業務から公式インターフェース GLM および公式製品 アカウント単位の同時実行制限、単一依存 単一モデル、深い利用
API ゲートウェイ 業務からゲートウェイ、さらにモデル ゲートウェイで開通済みの複数モデル ゲートウェイのレート制限、切り替え設定可能 複数モデル、請求の統一

五、支払い、請求書、データコンプライアンス

中国国内チームの選定では、技術指標よりも支払いと請求書が方式を左右することがよくあります。公式への直接チャージは人民元決済で、実際の消費に応じて請求書が発行されます。ゲートウェイへのチャージはゲートウェイの請求に基づいて請求書が発行されます。どちらも越境決済と為替変動の手間を減らせますが、請求書の発行主体、種類、支払期日が異なるため、調達前に確認が必要です。

データコンプライアンスは個別に評価します。まずデータを分類します。公開コンテンツ、社内資料、個人情報、機密業務データです。レベルごとに保存、マスキング、監査の要件が異なります。第三者の API を使う前にデータ処理条項を読み、学習利用の有無、保持期間、保存場所を確認します。個人情報や業界規制データを扱う場合は、公開後に資料を揃えるのではなく、事前に法務とセキュリティチームのレビューを受けてください。

六、直結とゲートウェイの選び方

実用的な判断方法は 3 つを見ることです。モデル数、請求の複雑さ、障害許容度。

GLM だけを使い、チームに監視とリトライの運用能力があるなら直結が簡単です。3 つ以上のモデルを同時に使い、財務が請求をまとめたいなら、ゲートウェイのほうが管理コストを抑えられます。業務が中断に極めて敏感なら、どちらを選んでも主備切り替えとフォールバックを設計し、単一入口に依存しないようにします。

ハイブリッドもよくあります。中核業務は公式直結、非中核または実験的な業務はゲートウェイ経由にする。または主経路をゲートウェイ、代替経路を公式直結にする。重要なのは Base URL、キー、モデル名を設定化し、切り替え時にコードを変更しないことです。

障害切り替えには発動条件を定義します。連続タイムアウト、5xx 比率の上昇、最初のバイトの遅延が基準超過などです。代替モデルは事前に評価し、切り替え後の品質急落を避けます。切り替えプロセスにはサーキットブレーカーとハーフオープン探索を入れ、復旧直後にトラフィックで押しつぶされないようにします。

七、公開前の検証チェックリスト

  1. 本番ネットワークから DNS、TLS、最初のバイトの遅延テストを実行する。
  2. 実際のプロンプトで品質と利用量の比較を 1 巡行う。
  3. ピーク同時実行で負荷試験を行い、1302、1305 の発生条件を観察する。
  4. タイムアウト、リトライ、冪等、キューのピーク削減が機能するか検証する。
  5. 主備切り替えを 1 回演習し、復旧時間とデータ整合性を記録する。
  6. 請求の基準を突合し、請求書とコスト配分の方法を確認する。
  7. データ分類とコンプライアンスレビューを完了し、監査ログを保持する。

よくある質問（FAQ）

1. 中国国内から GLM API にアクセスするのに特別なネットワークは必要ですか？

公式サービスは中国国内の利用者向けで、通常は追加の越境ネットワークは不要です。企業ネットワークにプロキシ、許可リスト、DNS 制限がある場合は、運用担当者に対象ドメインの許可を依頼してください。

2. 直結とゲートウェイはどちらが安定していますか？

絶対的な答えはありません。直結は経路が短い一方で単一依存が強く、ゲートウェイは統一入口と切り替え能力を提供する代わりに依存が 1 層増えます。安定性はリトライ、キュー、監視、演習から生まれるもので、入口そのものから生まれるものではありません。

3. ゲートウェイは自動でモデルを切り替えますか？

ゲートウェイの実装と設定によります。接続前に切り替え条件、代替モデル、タイムアウト閾値、課金方式を確認し、実際に演習してください。デフォルトで有効になっていると仮定しないでください。

4. レート制限された場合はどうすればよいですか？

まず 1302 と 1305 を区別します。アカウント制限なら同時実行を下げる、キューイングする、上限引き上げを申請する。プラットフォーム混雑ならバックオフしてリトライし、高頻度リトライで混雑を悪化させないようにします。

5. 請求書と契約はどう扱いますか？

公式とゲートウェイでは請求書の発行主体が異なります。調達前に契約主体、請求書の種類、税率、支払期日を確認し、支払い経路と一致させてください。

関連記事