簡単な答え
502 は一時的なものです — お客様側で設定変更は不要です:
- 根本原因はサービスコンテナの自動再起動です — 再起動中は Web コンソールにアクセスできず、API は 502 を返します。これらは同じ事象です。
- 復旧は通常 1 分以内に自動で行われます — 30〜60 秒待ってから、リクエストを再送してください。
- 失敗した呼び出しは課金されません — 502 の間はリクエストが実際にサービスへ到達しないため、課金レコードは作成されません。
- クライアント側で自動リトライを追加してください — 約 30 秒後に 1 回リトライすれば、再起動ウィンドウ全体をシームレスに乗り切れます。
何が起きているのか
502 Bad Gateway とは、ゲートウェイ層はリクエストを受け取ったものの、バックエンドサービスへ転送した際に応答を受け取れなかったことを意味します。
APIYI では、一時的な 502 の大半は バックエンドサービスのコンテナが自動再起動したことが原因です。バックエンドプロセスが一時的に利用できない間は、次のようになります。
- Web コンソール(ダッシュボード、チャージページなど)が読み込めない、またはエラーを表示する
- API(
api.apiyi.comおよびその他すべてのエンドポイント)が 502 を返す
この種の 502 は、コード、キー、残高、またはネットワーク設定とは一切関係ありません。 初めてこのエラーを目にした場合、クライアント側でデバッグすることはありません。30〜60 秒待って再試行してください。大半の場合、サービスはすでに復旧しています。
実施すべきこと
1
手順 1: 30〜60 秒待ってから、リクエストを再送信してください
コンテナの再起動は通常 1 分以内に完了します。失敗した API 呼び出しは課金されないため、再試行しても二重課金は発生しません。
2
手順 2: Web コンソールが読み込まれない場合は、ページを強制再読み込みしてください
復旧後も、ブラウザーにキャッシュされたエラーページが表示されることがあります。Ctrl+Shift+R(Windows)または Cmd+Shift+R(Mac)を使用して強制再読み込みし、通常のインターフェースを表示してください。
3
手順 3: 502 が 5 分以上続く場合は、サポートに連絡してください
一時的な再起動は通常数分以上は続きません。502 が 5 分以上続く 場合は、通常の自動再起動ではありません。— このページ下部の連絡方法からご連絡いただき、発生したおおよその時刻(タイムゾーン付き、例:
14:30 (UTC+8))も併せてお知らせください。プログラムからの呼び出しに自動リトライを追加する
可用性に敏感なワークロードでは、502 のような一時的なエラーに対して、クライアント側で自動リトライを追加してください。30秒ほど後に1回再試行すれば、再起動ウィンドウ全体をカバーできます。- Python
- Node.js
- cURL
よくある質問
502 が発生したときに送信したリクエストは課金されますか?
502 が発生したときに送信したリクエストは課金されますか?
いいえ。 502 は、リクエストが実際にはバックエンドサービスに到達していないことを意味します。モデルの利用は発生していないため、課金記録には何も表示されません。これは診断にも便利です。失敗したリクエストが 呼び出しログ に課金エントリとして記録されていなければ、サーバー側では処理されていません。そのまま再送して問題ありません。
502 は、タイムアウト、429、524 とどう違うのですか?
502 は、タイムアウト、429、524 とどう違うのですか?
502: バックエンドサービスが一時的に利用できません(コンテナの再起動中です)。30〜60 秒待ってから再試行してください。課金されません。- タイムアウト / 切断された接続: クライアントのタイムアウトが短すぎます。サーバー側では、リクエストを引き続き実行中で、通常どおり課金している可能性があります。API タイムアウトを回避する方法 をご覧ください。
429: 同時実行数またはレート制限に達しています。サービスの可用性とは無関係です。API 同時実行数の制限 をご覧ください。524: 100 秒前後を超えるリクエストでapi-cf.apiyi.comの CDN エンドポイントを使用しています。エンドポイントを切り替えてください。
ウェブコンソールと API が同時に失敗するのはなぜですか?
ウェブコンソールと API が同時に失敗するのはなぜですか?
ウェブコンソールと API は同じサービスで支えられています。コンテナの再起動中は、両方が同時に利用不可になり、同時に復旧します。そのため、「ウェブサイトもダウンしている」という状況こそが、これはクライアント設定の問題ではなく、一時的なプラットフォーム側の事象であることの確認になります。
これは頻繁に起こりますか?
これは頻繁に起こりますか?
いいえ。定常的に発生するものではありません。一時的な 502 は、通常、急激なトラフィックの急増に関連しており、散発的に発生します。2026 年 8 月時点で、バックエンドサーバーのアップグレードとスケールアップを進めています。これにより、こうした一時的な 502 の発生頻度は大幅に減少します。プラットフォーム側で障害が発生した場合は、その都度ただちに リアルタイムのステータスフィード でステータス更新と復旧状況を公開します。
プラットフォーム側の問題か、自分のネットワークの問題かをどう見分ければよいですか?
プラットフォーム側の問題か、自分のネットワークの問題かをどう見分ければよいですか?
すぐに確認できる方法は 2 つあります。それでも別のネットワークで 5 分以上ずっと 502 が返る場合は、サポートにお問い合わせください。
- ウェブコンソールを開く:
api.apiyi.comが 502 を返し、コンソールも読み込めない場合は、ほぼ間違いなく一時的なプラットフォーム側の再起動です。1 分ほど待ってください。 - ネットワークを切り替える: モバイルデータ(別のキャリア)を使ってコンソールを読み込むか、以下のコマンドを実行してください。そこで動作するなら、問題はローカルネットワークまたはプロキシです。
関連ドキュメント
API タイムアウトを回避する方法
タイムアウト設定、推論モデルの遅延、524 の診断
API を使用するのにプロキシは必要ですか?
直結接続の注意点とネットワーク要件
APIYI のサーバーはどこにありますか?
ノードの所在地、レイテンシーのテスト、購入に関するアドバイス
サービス可用性と SLA
可用性のコミットメントとインシデント対応
お問い合わせ
WeCom サポート

メール
サポート: [email protected]ビジネス: [email protected]