Skip to main content

簡単な答え

502 は一時的なものです — お客様側で設定変更は不要です:
  1. 根本原因はサービスコンテナの自動再起動です — 再起動中は Web コンソールにアクセスできず、API は 502 を返します。これらは同じ事象です。
  2. 復旧は通常 1 分以内に自動で行われます — 30〜60 秒待ってから、リクエストを再送してください。
  3. 失敗した呼び出しは課金されません — 502 の間はリクエストが実際にサービスへ到達しないため、課金レコードは作成されません。
  4. クライアント側で自動リトライを追加してください — 約 30 秒後に 1 回リトライすれば、再起動ウィンドウ全体をシームレスに乗り切れます。

何が起きているのか

502 Bad Gateway とは、ゲートウェイ層はリクエストを受け取ったものの、バックエンドサービスへ転送した際に応答を受け取れなかったことを意味します。 APIYI では、一時的な 502 の大半は バックエンドサービスのコンテナが自動再起動したことが原因です。バックエンドプロセスが一時的に利用できない間は、次のようになります。
  • Web コンソール(ダッシュボード、チャージページなど)が読み込めない、またはエラーを表示する
  • API(api.apiyi.com およびその他すべてのエンドポイント)が 502 を返す
どちらも同じサービスで動作しているため、同時に失敗し、同時に復旧します。異常が検出されると、システムは自動的に再起動を完了します。処理全体は、通常 1 分以内に完了し、手動介入は不要です。
この種の 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回再試行すれば、再起動ウィンドウ全体をカバーできます。
このリトライ戦略は、リクエストがサービスに到達しなかった 502/503 系のエラーにのみ適用してください。 クライアントのタイムアウト(または 524)で中断されたリクエストは、サーバー側ではまだ実行中である可能性があり、通常どおり課金されます。そうしたリクエストを無条件に再試行すると、重複課金の原因になります。その種の問題については、API タイムアウトを回避する方法 を参照してください。
高頻度のワークロードでは、指数バックオフ(1秒、次に2秒、次に4秒)を使って素早く試行することもできます。ネットワークの一時的な不調による 502 は、たいてい数秒で解消します。それでもこれらの試行が失敗する場合は、コンテナ再起動のケースに備えて 30秒間隔に切り替えてください。

よくある質問

いいえ。 502は、リクエストが実際にはバックエンドサービスに到達しなかったことを意味します。モデルの利用は発生していないため、課金記録には何も表示されません。これは便利な診断方法でもあります。失敗したリクエストに呼び出しログ上の課金エントリがない場合、そのリクエストはサーバー側で処理されておらず、安全に再送できます。
  • 502: バックエンドサービスが一時的に利用できません(コンテナの再起動中)。30〜60秒待って再試行してください。課金されません。
  • タイムアウト / 接続切断: クライアントのタイムアウトが短すぎます。サーバーでは引き続きリクエストが実行され、通常どおり課金される可能性があります。APIタイムアウトを回避する方法を参照してください。
  • 429: 同時実行数またはレート制限に達しています。サービスの可用性とは無関係です。API同時実行数の制限を参照してください。
  • 524: CDNエンドポイント(api-cf.apiyi.com)で、およそ100秒を超えるリクエストを実行しています。エンドポイントを切り替えてください。
これらにはまったく異なる対応が必要です。直接再試行すべきなのは502/503のみです。
WebコンソールとAPIは同じサービスによって支えられています。コンテナの再起動中は両方とも同時に利用できなくなり、同時に復旧します。そのため、「Webサイトも停止している」という状況は、クライアント設定の問題ではなく、一時的なプラットフォーム側の事象であることを正確に示しています。
いいえ。定常的に発生するものではありません。一時的な502は通常、急激なトラフィックスパイクに関連しており、散発的に発生します。2026年8月現在、バックエンドサーバーのアップグレードとスケールアップを進めています。これにより、このような一時的な502の発生頻度は大幅に低減されます。プラットフォーム側のインシデントが発生した場合は、ライブステータスフィードで直ちにステータス更新と復旧状況を公開します。
次の2つをすばやく確認してください。
  1. Webコンソールを開く: api.apiyi.com が502を返し、コンソールも読み込めない場合は、ほぼ確実に一時的なプラットフォーム側の再起動です。1分ほど待ってください。
  2. ネットワークを切り替える: モバイルデータ通信(別のキャリア)でコンソールの読み込みを試すか、以下のコマンドを実行してください。そこで動作する場合、問題はローカルネットワークまたはプロキシにあります。
別のネットワークでも5分以上すべてが502を返し続ける場合は、サポートにお問い合わせください。また、Webコンソールは正常に動作する一方で、スクリプトでは本文が空の断続的な502が発生し、それらのリクエストが呼び出しログにない場合、502はローカルのプロキシソフトウェアに起因している可能性が高いです。スクリプトで502が発生するが呼び出しログに何もない場合を参照してください。

関連ドキュメント

API タイムアウトを回避する方法

タイムアウト設定、推論モデルの遅延、524 の診断

API を使用するのにプロキシは必要ですか?

直結接続の注意点とネットワーク要件

APIYI のサーバーはどこにありますか?

ノードの所在地、レイテンシーのテスト、購入に関するアドバイス

サービス可用性と SLA

可用性のコミットメントとインシデント対応

お問い合わせ

WeCom サポート

WeCom サポートのQRコードQRコードをスキャンするか、このカードをクリックしてサポートへ直接お問い合わせください継続的な 502 の報告とインシデントの切り分け

メール

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