---
title: "LLM API の 401・402・409・429 エラーとリトライの判断 | BroadRouter"
description: "BroadNet Inference API が返す HTTP ステータスの意味、指数バックオフでリトライすべきもの、先に修正すべきもの、サポートにリクエスト ID と一緒に送る情報をまとめました。"
url: https://broadrouter.com/ja/guides/errors-and-retries/
lang: ja
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。 [英語の原文を読む](https://broadrouter.com/guides/errors-and-retries/) (2026-11-14 更新).

# BroadNet Inference のエラーコードとリトライすべき場合

更新日 2026-11-14

ボディをパースする前に HTTP ステータスを確認してください。429 と 5xx は、上限を設けた指数バックオフでリトライします。400、403、413、422 はリトライ前に修正が必要です。401 はキーと残高を、402 はアカウントへの入金を確認してください。サポート用に X-Request-ID ヘッダーは必ずログに残してください。

API は通常の HTTP ステータスと、機械可読なエラーコードを返します。次にどうするかはステータスで決めてください。この表は BroadNet の [API リファレンス](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-errors-and-retries&utm_content=body#errors)に沿っています。

| ステータス | 意味 | 対処 |
| --- | --- | --- |
| 400 / 422 | リクエストまたはフィールドが無効 | まずリクエストを修正する |
| 401 | キーがない・無効・期限切れ、従量課金の予算がブロックされている、または利用枠を使い切った | キーの状態とアカウント残高を確認する |
| 402 `insufficient_balance` | アカウントで購入代金をまかなえない。ボディに残高と価格が入る | アカウントに入金してから再試行する |
| 403 | モデル、ルート、IP のポリシーで拒否された | 不一致を直す。例：[IP 許可リスト](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/) |
| 409 | アカウントの状態と競合：`mint_in_progress`、`key_limit_reached`、`credential_limit_reached`、`key_pending` | リトライするのは `mint_in_progress` だけ。同じ `request_id` を使う |
| 413 | リクエストが大きすぎる。文字起こしのファイルは 26,214,400 バイトまで | リクエストを小さくする |
| 429 | レート、同時実行数、トークンレート、または支出の上限に達した | レスポンスの詳細を読み、待ってからリトライする |
| 500 / 502 / 503 / 504 | サーバー側の処理 | 上限を設けた指数バックオフでリトライする。時間制キーの購入では同じ `request_id` を再利用する |

BroadNet のドキュメントでは、JSON ボディをパースする前に HTTP ステータスを確認し、そのうえで機械可読な `error` コードがあれば読むよう説明しています。

## 429 の原因になる上限は？

従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。BroadNet のドキュメントでは、時間制キーは毎分 120 リクエスト、1 ストリーム、毎分 300,000 トークンです。[無制限プラン](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)では、1 セッションにつき同時に 1 リクエストを処理します。これらの上限を OpenAI、Anthropic、Groq、DeepSeek と比べるには、[プロバイダー別の LLM API レート制限](https://broadrouter.com/ja/blog/llm-api-rate-limits-by-provider/)を読んでください。

## OpenAI SDK でリトライするには？

[GitHub の README](https://github.com/openai/openai-python#retries) によると、OpenAI Python SDK は接続エラー、408、409、429、5xx のレスポンスを、デフォルトで 2 回、短い指数バックオフでリトライします。デフォルトのタイムアウトは 10 分です。どちらも明示的に設定してください。

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_retries=4,   # 0 turns automatic retries off
    timeout=120,     # seconds; raise it for long reasoning answers
)
```

コード内のコメントの意味は、`max_retries=0` で自動リトライが止まること、`timeout` の単位は秒で、推論が長い回答では値を上げることです。

## 独自のバックオフを書くには？

SDK を使わずに API を呼ぶ場合は、試行回数と待ち時間の両方に上限を設けてください。

```python
import random, time, requests

RETRY = {429, 500, 502, 503, 504}

def post_with_backoff(url, headers, body, tries=5):
    for attempt in range(tries):
        r = requests.post(url, headers=headers, json=body, timeout=120)
        if r.status_code not in RETRY:
            return r                      # success, or an error to fix rather than retry
        time.sleep(min(30, 2 ** attempt) + random.random())
    return r
```

400、403、413、422 を内容を変えずにリトライしてはいけません。同じリクエストは同じように失敗します。チャットのリクエストをリトライするたびに新しい推論になり、従量課金ではもう一度課金されます。一般的なパターンは[指数バックオフ](https://broadrouter.com/ja/glossary/exponential-backoff/)を参照してください。

## 時間制キーの購入を安全にリトライする

`POST /portal/keys/hourly` は `request_id` を受け取ります。タイムアウト、接続の切断、409 `mint_in_progress`、5xx の後は、**同じ** `request_id` でリトライしてください。再利用した `request_id` で 2 本目のキーが作られたり課金されたりすることはありません。再送には `already_issued: true` とエイリアスが返ります。最初の結果がわかるまで、新しい ID を生成しないでください。詳しくは[冪等性キー](https://broadrouter.com/ja/glossary/idempotency-key/)を参照してください。

## トラブルシューティング

-   **チャージ直後の 401。** BroadNet のアカウントページには直近に記録された利用枠が表示され、入金の変更は反映中であることが示されます。ページを再読み込みし、反映が終わってから再試行してください。
-   **毎分数リクエストしか送っていないのに 429。** 4 リクエストの同時実行数の上限に当たっている可能性が高いです。たとえば長いストリームを並列で走らせている場合です。小さなワーカープールを使ってください。
-   **あるモデルでは 403 で、別のモデルでは通る。** キーのポリシーがそのモデルやルートを対象にしていません。たとえばプランのキーは `broadnet/deepseek-v4.1-flash` 用で、時間制キーは `broadnet/gemma-4-26b-a4b` だけが対象です。
-   **SDK がリトライして二重に課金された。** リトライしたチャットのリクエストは新しい推論です。重複した回答のほうが失敗より高くつく場面では `max_retries=0` にしてください。

## サポートに送るもの

`X-Request-ID` ヘッダーの値、UTC のタイムスタンプ、ルート、HTTP ステータス、キーのエイリアスを添えてください。キーそのものは絶対に送らないでください。ヘッダーの読み方は [OpenAI Python SDK のガイド](https://broadrouter.com/ja/guides/openai-python-sdk/)で説明しています。

## このガイドの用語

[指数バックオフ（exponential backoff）](https://broadrouter.com/ja/glossary/exponential-backoff/)

指数バックオフ（exponential backoff）とは、失敗するたびに待ち時間を長くして再試行するリトライ戦略で、通常は上限まで遅延を 2 倍ずつ増やします。各待ち時間にランダムなジッターを加えると、多数のクライアントの再試行が分散し、同時にサーバーへ集中しなくなります。

[同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/)

同時実行数（concurrency）とは、クライアントが同時に処理中にしているリクエストの数です。開いているリクエストは応答が終わるまで GPU の容量を占有するため、LLM API は毎分リクエスト数とは別に、キーやプランごとにこれを制限することがよくあります。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[リクエストタイムアウト（request timeout）](https://broadrouter.com/ja/glossary/request-timeout/)

リクエストタイムアウト（request timeout）とは、HTTP クライアントがサーバーを待つ最長時間で、超えるとリクエストを諦めます。通常は接続タイムアウトと読み取りタイムアウトに分かれます。長い回答には時間がかかるため、LLM では読み取りタイムアウトを長めにします。

[冪等キー（idempotency key）](https://broadrouter.com/ja/glossary/idempotency-key/)

冪等キーとは、決済や購入など状態を変えるリクエストにクライアントが付ける一意の値で、通常は UUID などのランダムな ID です。同じキーで同じリクエストが再送されると、サーバーは処理を 2 回実行せず、最初の結果を返します。

## よくある質問

### LLM API の 429 エラーはリトライすべきですか？

はい。上限を設けた指数バックオフでリトライしてください。BroadNet Inference の 429 は、レート、同時実行数、トークンレート、または支出の上限に達したことを意味します。頻発するなら並列度を下げ、原因が支出の上限ならリトライをやめてください。

### キーは正しいのに 401 になるのはなぜですか？

BroadNet の 401 は、キーの誤りや期限切れだけでなく、従量課金の利用枠の使い切りや予算のブロックも含みます。アカウントページで残高とキーの状態を確認してください。

### ここでの 401 と 403 の違いは何ですか？

401 はキーかアカウントの利用枠の問題です。403 はキーは有効でも、モデル、ルート、IP のポリシーでリクエストが拒否されたことを意味します。たとえば許可リストにないアドレスからの呼び出しです。

### OpenAI SDK はエラーを自動でリトライしますか？

はい。OpenAI Python SDK は、接続エラー、408、409、429、5xx をデフォルトで 2 回、短い指数バックオフでリトライします。回数を変えるには max\_retries を設定し、0 にするとリトライしなくなります。

## 関連ガイド

-   [chat completions のストリーミングと接続切断への対処](https://broadrouter.com/ja/guides/streaming-chat-completions/)
-   [IP 許可リストで API キーを自社サーバーに限定する](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)
-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)

実際のワークロードで試してください。 新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-errors-and-retries&utm_content=page-cta) ·

**出典**

-   [BroadNet Inference API リファレンス、エラーとリトライ （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-errors-and-retries&utm_content=sources#errors)
-   [BroadNet Inference API リファレンス、上限 （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-errors-and-retries&utm_content=sources#limits)
-   [OpenAI Python SDK の README、リトライとタイムアウト（2026-11-14 確認）](https://github.com/openai/openai-python#retries)
