中国国内で Gemini API を呼び出すとき、難しいのはコードではなく経路であることがほとんどです。リクエストが安定して出るか、レイテンシが許容範囲か、割当が足りるか、問題が起きたときに誰が対応するか。多くのチームは個人用プロキシで一旦通し、そのまま同じ設定を本番に持ち込み、同時実行、レート制限、コンプライアンスで次々に手戻りします。
本記事では、一般的な方式を直結、自社プロキシ、国内 AI ゲートウェイの 3 つに分け、適用範囲、割当の扱い、公開方法を説明します。結論を先に言うと、試作段階では使いやすい方法で構いませんが、本番環境では「監視できる、フォールバックできる、コンプライアンスを説明できる」基準で選びます。
注記:Google、Gemini はその権利者の商標です。本記事は 2026 年 10 月時点の一般的なネットワークとインターフェースの状況を例にしています。サービス提供地域、割当、規約は公式ページを基準とし、現地の法令とプラットフォーム利用規約を遵守してください。
一、3 つの方式を横並びで比較する
| 観点 | 公式直結 | 自社プロキシ | 国内 AI ゲートウェイ |
|---|---|---|---|
| 一般的な可用性 | ネットワークと地域の影響が大きい | 出口の品質に依存 | 提供者が確保し、ステータスページで確認可能 |
| レイテンシ | 変動が大きい | 最適化できるが 1 ホップ増える | 通常は比較的安定 |
| 運用コスト | 低いが障害調査が難しい | 高く、サーバーと出口の保守が必要 | 低く、API として利用 |
| 割当 | 公式のレートと地域制限を受ける | 公式割当は変わらない | ゲートウェイ側で配分・制限 |
| 課金 | 米ドル、従量制 | 公式費用にサーバー費用が加わる | 人民元、プリペイド |
| コンプライアンス説明 | 越境経路を自社で説明 | 出口とログの責任を自社で負担 | 国内契約とサービス境界がある |
| 向く場面 | 個人検証、低感度タスク | ネットワーク運用チームを持つ内部システム | 顧客向けの本番業務 |
この表は判断を代行するものではなく、プロキシは「通るかどうか」しか解決せず、割当、請求、コンプライアンスは解決しないという注意喚起です。プロキシを長期の本番方式とみなすことは、不確実性を経路に残すことと同じです。
二、直結:ネットワーク問題か権限問題かを先に切り分ける
直結の失敗は主に 3 つの状況で起こります。調査の順序を乱さないでください。
- 地域が利用不可:公式サービスが対象外の地域では、リクエストがタイムアウトするか直接拒否されます。キーを替えても解決しません。
- ネットワーク不通:DNS 解決、TLS ハンドシェイク、出口ルートのいずれかで問題が起きます。
curl -vでどこで止まるかを確認します。 - 認証またはプロジェクトの誤り:401 はキーの問題、403 は多くの場合プロジェクト、API 未有効化、モデル権限の問題です。
export GEMINI_API_KEY="あなたのキー"
curl -v "https://generativelanguage.googleapis.com/v1beta/models" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
--max-time 15
接続段階でタイムアウトするなら、後からパラメータを調整しても意味がありません。接続できて 4xx が返るなら、ステータスコード別に調査します。失敗した段階、所要時間、ステータスコードを毎回記録して初めて、偶発的な変動か構造的な利用不可かを判断できます。
三、自社プロキシ:接続は解決するが割当は解決しない
自社プロキシの典型的な構成は、業務サーバー → 海外出口 → Gemini API です。ネットワーク運用能力があり、データ感度を制御できるチームに向いていますが、次の 4 点を運用マニュアルに書き込む必要があります。
- 出口 IP が安定しているか、対象サービスに異常トラフィックと判定されないか。
- プロキシ層がリクエスト内容を記録するか、ログをどのくらい保持し、誰がアクセスできるか。
- 証明書、ドメイン、ポートをどう管理し、失効時にどうアラートするか。
- プロキシサーバー自体の帯域、同時実行、障害切り替え。
プロキシは公式の割当を増やしません。無料枠や低いクラスの RPM、TPM 制限はそのままで、ピーク時には同じように待ち行列が発生します。よりよくある問題は、すべての業務が 1 つの出口を共有し、1 つのスクリプトが暴走して経路全体を止めることです。そのため、業務別に出口とレート制限を分けることが必要です。
四、ゲートウェイ接続:通常は 3 か所だけ変更する
国内 AI ゲートウェイは一般に OpenAI 互換の入口を提供するため、既存コードは Base URL、キー、モデル名だけを変更すれば済みます。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ZSQH_API_KEY"],
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="<価格ページに記載の Gemini モデル名>",
messages=[{"role": "user", "content": "OK とだけ返してください"}],
max_tokens=64,
)
print(resp.choices[0].message.content)
print(resp.usage)
モデル名は本サイトのモデル価格ページを基準とし、サンプルをそのままコピーしないでください。接続後はまず最小リクエストを 1 本実行し、次に実際のタスクを一批流します。重点的に見るのは、最初の文字までの遅延、失敗率、返答内容が劣化していないかの 3 点です。ゲートウェイはサービスの境界であるため、選ぶ前にステータスページ、サポート窓口、返金規則、データ条項を確認してください。
五、割当と 429:リトライを正しく書く
Gemini の割当は通常、モデル、プロジェクト、時間枠ごとに計算され、一般的な軸は毎分のリクエスト数、毎分のトークン数、1 日あたりのリクエスト数です。制限に達すると通常 429 が返り、その処理方法が障害の拡大を左右します。
- 指数バックオフとランダムジッターを使い、全クライアントが同時刻にリトライするのを避ける。
- 最大リトライ回数と全体タイムアウトを設定し、超えたらフォールバックする。無限に再送しない。
- 業務の優先度でキューイングし、対話リクエストをオフラインバッチより優先する。
- 書き込み操作を冪等にし、リトライによる重複副作用を防ぐ。
- 429 の時間分布を監視し、分単位のレート制限か日次割当の枯渇かを判断する。
- 代替モデルまたは代替経路を用意し、主経路の制限時に自動切り替えする。
日次割当の枯渇ならリトライは無意味で、クラスを下げる、非重要呼び出しを減らす、割当を調整するのいずれかが必要です。同時実行の急増なら、先に制限してから拡張します。順序を逆にすると経路全体が遅くなるだけです。
六、コンプライアンスとデータ:必ず答える 3 つの質問
- リクエストに個人情報、顧客契約、コード、財務データが含まれるか。
- データがどのノードを通り、どの地域に保存され、ログがどのくらい保持されるか。
- セキュリティインシデント時に、誰が記録を提供でき、どのくらい速く通知できるか。
越境経路が長いほど説明コストは高くなります。顧客向けの本番システムでは、データを分類・階層化し、機密フィールドを先にマスキングします。ログを保持する場合は、アクセス権限と削除手順を明確にします。「API を 1 つ呼ぶだけ」という理由でコンプライアンスレビューを飛ばさないでください。
七、公開手順
- 実際のタスクで 1 週間の負荷試験を行い、ピークと閑散時間の両方をカバーする。
- 成功率、p50 と p95 のレイテンシ、429 の分布、単一タスクのコストを記録する。
- 割当上限と業務ピークの差を確認し、余裕を確保する。
- 監視とアラートを接続し、エラー率、レイテンシ、残高、レート制限をカバーする。
- 主備切り替えを演習し、フォールバック時に業務が許容できることを確認する。
- 契約書、請求書、データ条項、セキュリティ説明を保管する。
- 少量トラフィックで切り替え、1 週間観察してから全量に移行する。
よくある質問
Gemini API は中国国内から直接呼び出せますか?
直結の可否は公式のサービス地域、ネットワーク出口、アカウント状態によって決まり、実際にはタイムアウト、接続リセット、4xx が発生する可能性があります。1 回の成功や失敗で結論を出さず、1 週間の失敗率とレイテンシ分布で判断してください。
プロキシ経由のアクセスは安定していますか?
プロキシは接続性を改善しますが、安定性は出口の品質、同時実行、運用レベルに依存します。公式割当は変わらず、コンプライアンスやログの問題も自動では解決しません。本番利用には完全な監視とフォールバック計画が必要です。
なぜいつも 429 が返るのですか?
分単位のレート制限、日次割当の枯渇、同時実行の急増が考えられます。まずレスポンスヘッダーと利用量ページを見て、制限の種類を区別します。日次割当の枯渇ならリトライは無効で、割当の調整か非重要呼び出しの削減が必要です。
ゲートウェイはモデル能力を変えますか?
ゲートウェイは主に認証、ルーティング、レート制限、課金を行うもので、通常はモデル自体を変えません。ただし経路ごとに公開されるモデルの範囲、パラメータ対応、バージョンが異なる場合があるため、公開前に同じタスク群で比較テストを行ってください。
中国国内アクセスではどのコンプライアンス問題に注意すべきですか?
少なくとも、データが越境するか、個人情報を含むか、ログをどのくらい保持するか、提供者が契約とセキュリティ説明を出せるかを確認します。機密データを扱う場合は先にマスキングし、社内規程に沿ってレビューを完了してください。
次のステップ
プロキシと出口を自分で運用したくない場合は、まずZSQH AI Gateway で Gemini リクエストを 1 本通し、その後プロジェクト別にキーを分けて予算を設定します。利用可能なモデルと価格はモデル価格を基準とします。
関連記事:
