エラー 502：claude-opus-5 の呼び出しに失敗したときの対処

502 は、ゲートウェイが上流モデルサービスから不正な応答を受け取ったことを意味します。リクエストはゲートウェイに到達しましたが、上流への転送に失敗しました。

502 Bad Gateway は、ゲートウェイが upstream のモデルサービスから無効な応答を受け取ったことを意味します。リクエストはゲートウェイまで到達しており、失敗はゲートウェイから upstream への区間で発生しています。通常は upstream ノードの再起動や接続切断が原因です。

claude-opus-5 は Anthropic が提供しており、このページの誘因分析・対処法・実測データはすべてゲートウェイ層におけるこのモデルの実際の稼働実績に基づいています。

このゲートウェイで最も多い诱因は「上流モデルサービスが利用不可、または不正な応答を返した」です。まず取り組むべき対処は「まず一度再試行する（502 は多くが一時的）」です。

主な原因

• 上流モデルサービスが利用不可、または不正な応答を返した
• 上流ノードが再起動中
• ゲートウェイと上流の接続が切断された
• モデルが一時的に停止された

対処方法

• まず一度再試行する（502 は多くが一時的）
• 他ベンダーの同等モデルに切り替える
• 特定のモデルだけ 502 が続く場合は、その上流に異常がある
• 時間をおいて再試行するか、お問い合わせください

指数バックオフによるリトライ例

以下のコードは、claude-opus-5 が 502 を返したときに最大 5 回まで再試行します。待機時間は指数的に増加し、ランダムなジッタを加えることで同時再試行を防ぎます。base URL と API キーは環境変数から読み取り、コードに直接書かないでください。

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'claude-opus-5'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

このモデルの主要データ

よくある質問

このモデルの他のエラー

• claude-opus-5: エラー 429 の原因と対処法
• claude-opus-5: エラー timeout の原因と対処法
• claude-opus-5: エラー 500 の原因と対処法
• claude-opus-5: エラー 503 の原因と対処法
• claude-opus-5: エラー 504 の原因と対処法
• claude-opus-5: エラー 401 の原因と対処法
• claude-opus-5: エラー 403 の原因と対処法
• claude-opus-5: エラー 400 の原因と対処法

同じエラーが出る他のモデル

• gpt-5
• gemini-2.5-pro
• deepseek-v4-pro
• grok-4.3
• llama-3.3-70b-instruct
• qvq-max
• qwq-32b
• glm-5
• MiniMax-M3
• kimi-k3
• hy3
• doubao-seed-evolving
• mimo-v2.5
• gpt-4o
• claude-opus-4-6
• gemini-2.5-flash

モデルページに戻る

データ更新: 2026-10-10 15:45