簡単な答え
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: CDNエンドポイント(api-cf.apiyi.com)で、およそ100秒を超えるリクエストを実行しています。エンドポイントを切り替えてください。
WebコンソールとAPIが同時に失敗するのはなぜですか?
WebコンソールとAPIが同時に失敗するのはなぜですか?
WebコンソールとAPIは同じサービスによって支えられています。コンテナの再起動中は両方とも同時に利用できなくなり、同時に復旧します。そのため、「Webサイトも停止している」という状況は、クライアント設定の問題ではなく、一時的なプラットフォーム側の事象であることを正確に示しています。
これは頻繁に発生しますか?
これは頻繁に発生しますか?
いいえ。定常的に発生するものではありません。一時的な502は通常、急激なトラフィックスパイクに関連しており、散発的に発生します。2026年8月現在、バックエンドサーバーのアップグレードとスケールアップを進めています。これにより、このような一時的な502の発生頻度は大幅に低減されます。プラットフォーム側のインシデントが発生した場合は、ライブステータスフィードで直ちにステータス更新と復旧状況を公開します。
プラットフォームの問題か、自身のネットワークの問題かを見分けるにはどうすればよいですか?
プラットフォームの問題か、自身のネットワークの問題かを見分けるにはどうすればよいですか?
次の2つをすばやく確認してください。別のネットワークでも5分以上すべてが502を返し続ける場合は、サポートにお問い合わせください。また、Webコンソールは正常に動作する一方で、スクリプトでは本文が空の断続的な502が発生し、それらのリクエストが呼び出しログにない場合、502はローカルのプロキシソフトウェアに起因している可能性が高いです。スクリプトで502が発生するが呼び出しログに何もない場合を参照してください。
- Webコンソールを開く:
api.apiyi.comが502を返し、コンソールも読み込めない場合は、ほぼ確実に一時的なプラットフォーム側の再起動です。1分ほど待ってください。 - ネットワークを切り替える: モバイルデータ通信(別のキャリア)でコンソールの読み込みを試すか、以下のコマンドを実行してください。そこで動作する場合、問題はローカルネットワークまたはプロキシにあります。
関連ドキュメント
API タイムアウトを回避する方法
タイムアウト設定、推論モデルの遅延、524 の診断
API を使用するのにプロキシは必要ですか?
直結接続の注意点とネットワーク要件
APIYI のサーバーはどこにありますか?
ノードの所在地、レイテンシーのテスト、購入に関するアドバイス
サービス可用性と SLA
可用性のコミットメントとインシデント対応
お問い合わせ
WeCom サポート

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