中国国内のチームにとって、Qwen API の現実的な利点はサービス入口が国内にあることです。阿里云百炼経由で呼び出す場合、通常は越境ネットワークのために別の方案を設計する必要はありません。ただし「アクセスできる」と「安定して本番運用できる」は別問題で、後者はリージョン選択、レート制限、リトライ、請求、障害切り替えといったエンジニアリングの細部で決まります。

本記事では、百炼への直結と API ゲートウェイ経由の 2 方式を比較し、ネットワーク調査、容量計画、支払いと請求書、公開前の検証の具体的な方法を示します。結論は決め打ちしません。1 つのモデルだけを使う場合と、複数モデルを同時に接続する場合では、適した選択が異なります。

注記：Qwen、通義千問、阿里云、百炼、DashScope は阿里巴巴グループおよびその関連会社の商標です。本記事は技術的な説明のみを目的とし、阿里巴巴グループとの提携・代理関係はありません。エンドポイント、モデル範囲、レート制限規則、課金方式は、阿里云百炼の公式ドキュメントおよび管理画面を基準とします。

一、まず入口を確認する：百炼、DashScope、リージョン

阿里云百炼（Model Studio）はモデルサービスプラットフォームで、DashScope は実際に呼び出す API です。プラットフォームは OpenAI 互換モードと DashScope ネイティブモードの両方を提供します。互換モードでは OpenAI SDK をそのまま再利用でき、ネイティブモードではプラットフォーム固有のパラメータを保持できます。中国国内でよく使われる入口は北京リージョンの https://dashscope.aliyuncs.com/compatible-mode/v1 で、ネイティブモードは同じドメイン配下の /api/v1 です。

リージョンは気軽に切り替えられません。公式ドキュメントによると、API キーはリージョンと課金方案に紐づき、リージョンをまたぐ呼び出しは 401 を返します。本番環境ではワークスペース専用ドメインの利用も推奨されています。リージョンを選ぶときは、データの保存場所、モデルの提供状況、請求通貨を同時に確認し、ネットワークの疎通だけをテストしないでください。モデル ID もバージョン更新で変わるため、接続前に管理画面のモデル一覧を基準とします。

二、直結が向く状況

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

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

代償は単一依存です。アカウント単位のレート制限、残高不足、プラットフォームの混雑が業務に直接影響します。さらに DeepSeek、GLM なども接続する場合、チームは複数のキー、複数の Base URL、複数の請求を管理する必要があります。小規模チームはこの管理コストを過小評価しがちです。

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

API ゲートウェイは複数の提供者を 1 つの OpenAI 互換入口に集約します。一般的な価値は 4 点です。Base URL の統一、キーの統一、残高と請求の統一、監視の統一。Qwen、DeepSeek、Claude などを同時に使うチームは、提供者ごとのアダプターを書かずに済みます。

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

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

観点 百炼直結 API ゲートウェイ
ネットワーク経路 業務から百炼入口 業務からゲートウェイ、さらに上流
モデル範囲 Qwen および百炼で提供されるモデル ゲートウェイで開通済みの複数モデル
レート制限と障害 アカウント単位の RPM/TPM、単一依存 ゲートウェイのレート制限、切り替え設定可能
請求と請求書 阿里云の請求と請求書 ゲートウェイの統一請求と請求書
向く場面 単一モデル、深い利用 複数モデル、請求の統一

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

まず「ネットワーク問題」を 4 層に分けます。DNS 解決、TCP 接続、TLS ハンドシェイク、HTTP 応答です。以下は最小の診断コマンドで、QWEN_MODEL は環境変数から読み込み、スクリプトにモデル名を直書きしないようにします。

curl -v --connect-timeout 5 --max-time 30 \
  https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$QWEN_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"

重点的に見る指標は 3 つです。time_namelookup が異常なら DNS 問題、time_appconnect が長すぎれば TLS または経路の問題、time_starttransfer が想定を大きく超えればサーバー側の待ち行列またはネットワーク混雑です。401 の場合は、ネットワークを調べ続ける前にキーとリージョンが一致しているか確認します。

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

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

百炼のレート制限は阿里云の主アカウント単位で適用され、同じアカウント配下の RAM サブアカウント、ワークスペース、API キーは割当を共有します。モデルごとに RPM と TPM の割当があり、一部の場面では RPS、TPS による短時間の突発制御も行われ、新しいモデルの一部は月間消費クラスによる動的制限があります。つまり、キーをいくつも作ってもアカウント全体の割当を回避できません。

上限超過時は通常 429 が返りますが、メッセージは異なります。RPM 超過、TPM 超過、「リクエスト速度の上昇が速すぎる」では対応が異なります。無料枠を使い切り、該当スイッチが有効な場合は 403 が返ることがあります。公式ドキュメントは、チャージは未払い状態にのみ影響し、RPM/TPM は上がらないと明記しています。より高い割当が必要なら営業担当へ連絡します。

容量計画では日平均だけを見ないでください。ピーク同時実行で設計し、リトライと突発分の余裕を確保します。キューでピークを削り、定刻タスクが一斉に上限を打たないようにします。オフライン処理は Batch インターフェースに回し、オンライン同時実行をリアルタイムリクエストに残します。429 が返ったら指数バックオフし、高頻度リトライを避けます。

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

支払いと請求書は、技術指標よりも方案を左右することがよくあります。中国国内の阿里云アカウントは通常人民元決済で、阿里云が請求書を発行します。国際サイトのアカウントは通貨、契約主体、請求書の規則が異なります。ゲートウェイへのチャージはゲートウェイの請求に基づいて請求書が発行されます。調達前に契約主体、請求書の種類、税率、支払期日を確認し、支払い経路と請求書の発行主体を一致させてください。

データコンプライアンスは個別に評価します。まずデータを分级します。公開コンテンツ、社内資料、個人情報、機密業務データです。第三者の API を使う前にデータ処理条項を読み、学習利用の有無、保持期間、保存リージョンを確認します。個人情報を扱う場合は適用される個人情報保護法規に沿って評価し、業界規制データを扱う場合は事前に法務とセキュリティチームのレビューを受けてください。公開後に資料を揃えるのでは遅すぎます。

七、障害切り替えの方法

障害切り替えは「Base URL をもう 1 つ記入する」ほど単純ではありません。まず発動条件を定義します。連続タイムアウト、5xx 比率の上昇、最初のバイトの遅延が継続して基準超過などです。次に評価済みの代替モデルを用意し、切り替え後の品質急落を避けます。切り替えプロセスにはサーキットブレーカーとハーフオープン探索を入れ、復旧直後にトラフィックで押しつぶされないようにします。

Qwen を使う場合はリージョン紐づけに注意します。異なるリージョンのキーは混用できず、リージョンをまたぐ災害対策には個別にキーを申請し、データ保存要件を再評価する必要があります。マルチモデルの災害対策も同様で、代替モデルの能力境界、コンテキスト長、課金基準を事前に測定します。

エンジニアリング面では、Base URL、キー、モデル名を設定化し、切り替え時にコードを変更しません。公式直結をフォールバック経路として残します。演習のたびに復旧時間と失敗リクエストの処理結果を記録します。

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

  1. 本番ネットワークから DNS、TLS、最初のバイトの遅延テストを実行する。
  2. 実際のプロンプトで直結とゲートウェイの出力品質、トークン使用量を比較する。
  3. ピーク同時実行で負荷試験を行い、429 の発生条件と復旧時間を観察する。
  4. タイムアウト、リトライ、バックオフ、冪等、キューのピーク削減が機能するか検証する。
  5. 主備切り替えを 1 回演習し、復旧時間とデータ整合性を記録する。
  6. 請求の基準を突合し、請求書、コスト配分、予算アラートを確認する。
  7. データ分级とコンプライアンスレビューを完了し、監査ログを保持する。
  8. キーのローテーション、失効、権限境界を確認する。

九、よくある質問（FAQ）

中国国内から Qwen API にアクセスするのに越境ネットワークは必要ですか？

北京リージョンの百炼入口を使う場合、通常は不要です。企業ネットワークにプロキシ、許可リスト、DNS 制限がある場合は、運用担当者に dashscope.aliyuncs.com などの関連ドメインの許可を依頼してください。他のリージョンを使う場合は、ドメインとキーをそれぞれ合わせて調整する必要があります。

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

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

百炼のレート制限はアカウント単位ですか、キー単位ですか？

公式ドキュメントによると、レート制限は阿里云の主アカウント単位で適用され、同じアカウント配下の RAM ユーザー、ワークスペース、API キーは割当を共有します。モデルごとに RPM/TPM の割当があります。具体的な数値は管理画面とレート制限ドキュメントを基準とします。

チャージでレート制限の上限は上がりますか？

上がりません。公式ドキュメントは、チャージは未払い状態にのみ影響し、RPM/TPM の制限は変わらないと説明しています。より高い割当が必要なら営業担当へ連絡し、審査期間はプラットフォームの説明を基準とします。

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

直結は阿里云が請求書を発行し、ゲートウェイはゲートウェイ運営者が発行します。両者の契約主体、請求書の種類、支払期日は異なります。調達前に確認し、支払い主体と請求書の発行主体が不一致にならないようにしてください。

関連記事