中国国内のチームが Claude API に接続するとき、問題になるのは SDK ではなく経路であることがほとんどです。リクエストがどこから出るのか、費用をどう支払うのか、請求書をどう受け取るのか、レート制限時に業務をどう退避させるのか、障害時に誰が調査するのか。これらを分けて考えれば、方式は整理できます。
本記事では、公式直結、自社中継、国内 AI ゲートウェイという 3 つの一般的なルートを比較し、実装可能なタイムアウト、リトライ、フォールバック、監視の設定を示します。具体的なモデルと価格は本サイトのモデル価格を基準とし、本記事は法的・コンプライアンス上の助言ではありません。
注記:Anthropic、Claude、OpenAI はそれぞれの権利者の商標です。本記事は 2026 年 10 月時点の一般的な製品形態を例にしています。越境ネットワーク、データの越境移転、決済は、所在地の法令および各プラットフォームの利用規約に従う必要があり、実施前に法務・コンプライアンス担当者へご確認ください。
一、3 つのルートを整理する
公式直結は Anthropic が提供する API を直接呼び出す方式です。経路が最も短く、機能とドキュメントの同期も最も速いため、海外法人、海外の支払い手段、成熟した越境ネットワークをすでに持つチームに向いています。代わりに、ネットワーク品質、米ドル決済、為替、経費精算の証憑をすべて自社で処理する必要があります。
自社中継は、適法に運用できる海外サーバーにリバースプロキシまたはゲートウェイを配置し、認証、ログ、レート制限、課金を一元化する方式です。制御性は最も高いですが、運用、証明書、アップグレード、セキュリティ強化を自社で担う必要があります。サーバーの所在地とデータ処理を誤ると、かえってコンプライアンス上のリスクを拡大します。
国内 AI ゲートウェイは、国内のサービス提供者が OpenAI 互換の入口を用意し、人民元で決済する方式で、通常は管理画面、利用量統計、請求書が付属します。導入コストが低く、複数モデルの切り替えも容易ですが、提供者の資格、データ条項、サービスレベル、障害対応を確認する必要があります。
| 観点 | 公式直結 | 自社中継 | 国内 AI ゲートウェイ |
|---|---|---|---|
| ネットワークと接続 | 越境経路に依存し、自社で最適化が必要 | 回線を選択できるが、運用は自社対応 | 国内入口で、通常はすぐ利用可能 |
| 支払いと請求書 | 米ドル決済で、精算経路が長い | サーバーとアカウントの主体による | 人民元決済で、請求書の発行が可能 |
| コンプライアンスとデータ | 越境移転と規約を自社で評価 | データの所在と保持を自社で管理 | 提供者の規約と資格を審査する必要 |
| 運用コスト | 中程度。主にネットワークとアカウント | 高い。サーバー、証明書、更新 | 低い。管理画面で一元管理 |
| レート制限と障害 | リトライとフォールバックを自社実装 | レート制限とヘルスチェックを自社設計 | 提供者が一部対応。ただし自社検証は必要 |
| モデルの範囲 | Claude が中心 | 自社で拡張可能 | 通常は複数社のモデルをカバー |
二、ネットワークと経路:まず測定してから選ぶ
「つながるかどうか」だけを見てはいけません。本番環境では、最初のバイトまでの時間、長い応答の安定性、夜間ピーク時のパケットロス、切断後の再接続という 4 項目を測定します。ストリーミング出力は経路の影響を受けやすいため、「こんにちは」と 1 文送るのではなく、実際の長さのプロンプトで負荷試験を行うことをおすすめします。
自社中継では「プロキシ」と「ゲートウェイ」を区別してください。プロキシはリクエストを転送するだけですが、ゲートウェイは認証、レート制限、ログ、モデルルーティングも担えます。プロキシをそのまま公網に公開し、固定キー 1 本だけで運用するのはリスクが高く、少なくともアクセス制御、リクエストサイズ制限、異常アラートを追加すべきです。
越境経路は所在地の法律とプラットフォーム規約に従う必要があります。出所不明の共有プロキシを使わず、アカウントの認証情報を信頼できない第三者に渡さないでください。個人情報や重要データを扱う場合は、先にデータ分類と越境評価を行います。
三、支払い、契約、請求書
中国国内チームがつまずきやすいのは支払い主体です。個人カードでのチャージ、代理決済、経費証憑の不一致は、経理側で処理できないことがよくあります。方式を選ぶ前に、契約の相手方、決済通貨、発行できる請求書の種類、返金規則を確認してください。
国内ゲートウェイは通常、人民元の法人向け振込と増値税請求書に対応し、請求をプロジェクト単位やキー単位で集計できるため、複数モデルの支出を一元管理したいチームに向いています。公式直結は海外送金の手段をすでに持つチームに適しています。どのルートでも、価格、為替、税費、返金条件を発注書に明記し、具体的な費用はモデル価格と契約を基準にしてください。
四、コンプライアンスとデータの境界
少なくとも確認すべき項目は、入出力が学習に使われるか、データをどのくらい保持するか、どこに保存するか、データ処理契約を締結できるか、サブプロセッサには誰がいるか、セキュリティインシデントをどう通知するか、です。中国国内の利用者にサービスを提供する場合は、個人情報保護とデータ越境の要件も評価する必要があります。
実務的にはデータを分類します。公開資料は汎用チャネルで扱い、コード、契約、顧客情報は先にマスキングし、敏感な個人情報や重要データを含む場面は個別に評価して書面を残します。「まず使ってから考える」でコンプライアンス判断を置き換えないでください。
五、レート制限、タイムアウト、フォールバック
Claude API のレート制限は通常、リクエスト数、入力トークン数、出力トークン数という複数の軸で計算されます。急激なトラフィック、長いコンテキスト、並行リトライは 429 を引き起こし、サーバー側の混雑時には 529 が返ることもあります。正しい方法は、適切なタイムアウトを設定し、指数バックオフにランダムジッターを加え、最大リトライ回数を制限し、書き込み操作を冪等にすることです。
import os, random, time
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ZSQH_API_KEY"],
base_url="https://api.zhongshangqihang.com/v1",
timeout=60.0,
max_retries=0,
)
def chat(messages, model, fallback):
for name in [model, fallback]:
for attempt in range(4):
try:
return client.chat.completions.create(
model=name,
messages=messages,
max_tokens=1024,
timeout=60,
)
except Exception as exc:
status = getattr(exc, "status_code", None)
if status not in (429, 500, 502, 503, 504, 529):
raise
if attempt == 3:
break
time.sleep(min(2 ** attempt + random.random(), 8))
raise RuntimeError("primary and fallback both failed")
タイムアウトはタスクごとに設定します。通常の Q&A は短めで構いませんが、長文生成には十分な時間を確保します。長ければよいというものではなく、長時間の待機はコネクションプールを占有します。リトライは回復可能なエラーにのみ適用し、401、400、コンテキスト超過はリトライすべきではありません。
フォールバックの順序は、同一ベンダーの軽量モデル、他ベンダーの同クラスモデル、ルールまたはキャッシュ結果、とするのがおすすめです。フォールバックのスイッチは設定センターに置き、コードを変更して再リリースしないようにします。フォールバックのたびにモデル名と理由を記録してください。
六、キーの分離と監視
- 本番とテストでは別のキーを使い、さらにプロジェクト単位で分割する。
- キーはサーバー側の環境変数またはシークレット管理サービスにのみ置き、フロントエンド、リポジトリ、ログには入れない。
- キーごとに上限額またはアラート閾値を設定し、定期的にローテーションする。
- リクエスト数、エラー率、P95 レイテンシ、トークン消費、フォールバック回数を記録する。
- 401、429、5xx をそれぞれ別にアラートし、単一の「エラー率」で問題を覆い隠さない。
- リクエスト ID とモデル名を保持し、提供者との突合や調査に備える。
監視は API が 200 を返したかだけでなく、業務の結果までカバーします。たとえば JSON パース失敗率、ツール呼び出し成功率、空応答の比率は、HTTP ステータスコードより早くモデルやプロンプトの問題を露呈することがあります。
七、公開前チェックリスト
- アクセスルートと契約主体を明確にし、法務と財務のレビューを完了する。
- 実際のネットワーク環境で実トラフィックの負荷試験を行う。
- タイムアウト、リトライ、バックオフ、最大リトライ回数を設定する。
- 利用可能なフォールバックモデルを少なくとも 1 つ用意し、切り替えを演習する。
- キーの分類、上限設定、ローテーション計画を完了する。
- 利用量、エラー率、レイテンシ、フォールバックの監視を接続する。
- データ条項、請求書、振込控え、検収記録を保存する。
- 少量トラフィックでカナリアリリースし、1 週間観察してから拡大する。
よくある質問
Claude API は中国国内から直接接続できますか?
利用可否は所在地のネットワーク環境、アカウント資格、プラットフォーム規約によって異なります。本記事は制限を回避する方法を提供しません。チームは法令と利用規約に適合する接続方式を選び、契約と請求書が揃う国内ゲートウェイを優先的に検討してください。
ゲートウェイとプロキシの違いは何ですか?
プロキシは通常、リクエストを転送するだけです。ゲートウェイは認証、レート制限、ログ、課金、モデルルーティングも行います。本番環境ではゲートウェイで一元化し、生のプロキシを公網に公開しないことをおすすめします。
自社中継で注意すべきことは何ですか?
サーバーの所在地、データ保持、アクセス制御、証明書更新、障害対応をすべて自社で担う必要があります。越境配置の前にコンプライアンス評価を行い、機密データを管理不能な経路に置かないようにしてください。
429 が返ったらリトライを続けるべきですか?
続けるべきではありません。指数バックオフとランダムジッターを使い、回数を制限します。429 が続く場合はクォータまたは同時実行の設定不足を示すため、フォールバック、キューイング、クォータ調整で対応し、リトライを積み重ねないでください。
マルチモデルゲートウェイは安定性を下げますか?
層が 1 つ増えると障害点も 1 つ増えますが、切り替えとフォールバックの能力も増えます。重要なのは、提供者のサービスレベル、監視、障害通知、返金規則を確認し、自社でエンドツーエンドのヘルスチェックを行うことです。
次のステップ
まず実際のタスクを一批使い、ZSQH AI Gateway でテストキーを作成して、経路、レイテンシ、フォールバックを確認します。その後、環境ごとに本番キーを分割してください。モデルの範囲と費用はモデル価格を基準とします。
関連記事:
