---
title: "LLM API 오류 코드 401, 402, 409, 429: 재시도 기준 | BroadRouter"
description: "BroadNet Inference API의 HTTP 상태 코드별 의미, 백오프로 재시도할 오류와 먼저 고쳐야 할 오류, 요청 ID와 함께 지원팀에 보낼 정보를 정리했습니다."
url: https://broadrouter.com/ko/guides/errors-and-retries/
lang: ko
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=ko-guides-errors-and-retries&utm_content=body#errors)를 따릅니다.

| 상태 코드 | 의미 | 조치 |
| --- | --- | --- |
| 400 / 422 | 잘못된 요청 또는 필드 | 먼저 요청을 고치세요 |
| 401 | 키 누락, 유효하지 않거나 만료된 키, 차단된 종량제 예산 또는 소진된 사용 가능 금액 | 키 상태와 계정 잔액을 확인하세요 |
| 402 `insufficient_balance` | 계정 잔액으로 구매 금액을 충당할 수 없음. 본문에 잔액과 가격이 포함됨 | 계정을 충전한 뒤 다시 시도하세요 |
| 403 | 모델, 경로 또는 IP 정책에 의해 거부됨 | 불일치를 해결하세요. 예: [IP 허용 목록](https://broadrouter.com/ko/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/ko/guides/unlimited-llm-api-sessions/)에서는 세션마다 한 번에 요청 하나를 처리합니다. 이 한도를 OpenAI, Anthropic, Groq, DeepSeek과 비교하려면 [제공업체별 LLM API 속도 제한](https://broadrouter.com/ko/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 응답을 기본적으로 짧은 지수 백오프로 두 번 재시도합니다. 기본 타임아웃은 10분입니다. 두 값을 명시적으로 설정하세요. 아래 예에서 `max_retries`를 0으로 두면 자동 재시도가 꺼지고, `timeout`은 초 단위이므로 추론이 긴 답변에서는 늘리세요.

```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
)
```

## 백오프를 직접 구현하려면 어떻게 하나요?

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/ko/glossary/exponential-backoff/)를 참고하세요.

## 시간제 키 구매를 안전하게 재시도하기

`POST /portal/keys/hourly`는 `request_id`를 받습니다. 타임아웃, 연결 끊김, 409 `mint_in_progress`, 5xx가 발생한 뒤에는 **같은** `request_id`로 재시도하세요. 재사용한 `request_id`로는 두 번째 키가 생성되거나 과금되지 않으며, 재요청에는 `already_issued: true`와 별칭이 반환됩니다. 첫 번째 결과를 확인하기 전에는 새 ID를 만들지 마세요. 자세한 내용은 [멱등성 키](https://broadrouter.com/ko/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/ko/guides/openai-python-sdk/)에 나와 있습니다.

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

[멱등성 키(idempotency key)](https://broadrouter.com/ko/glossary/idempotency-key/)

멱등성 키(idempotency key)는 결제나 구매처럼 상태를 바꾸는 요청에 클라이언트가 붙이는 고유한 값으로, 보통 UUID 같은 무작위 ID입니다. 같은 요청이 같은 키로 다시 오면 서버는 작업을 두 번 수행하지 않고 처음 결과를 돌려줍니다.

[요청 타임아웃(request timeout)](https://broadrouter.com/ko/glossary/request-timeout/)

요청 타임아웃(request timeout)은 HTTP 클라이언트가 요청을 포기하기 전까지 서버를 기다리는 최대 시간입니다. 클라이언트는 보통 연결을 여는 연결 타임아웃과 데이터를 기다리는 읽기 타임아웃으로 나눕니다. 긴 답변은 시간이 걸리므로 LLM 호출에는 넉넉한 읽기 타임아웃이 필요합니다.

[지수 백오프(exponential backoff)](https://broadrouter.com/ko/glossary/exponential-backoff/)

지수 백오프(exponential backoff)는 클라이언트가 시도에 실패할 때마다 더 오래 기다렸다가 다시 시도하는 재시도 전략으로, 보통 상한까지 지연 시간을 두 배씩 늘립니다. 각 대기 시간에 무작위 지터를 더하면 여러 클라이언트의 재시도가 분산되어 같은 순간에 서버로 몰리지 않습니다.

## 자주 묻는 질문

### LLM API에서 429 오류가 나면 재시도해야 하나요?

네. 상한을 둔 지수 백오프로 재시도하세요. BroadNet Inference의 429는 요청 속도, 동시 실행 수, 토큰 속도 또는 지출 한도에 도달했다는 뜻입니다. 계속 발생하면 병렬 처리 수를 줄이고, 원인이 지출 한도라면 재시도를 멈추세요.

### 키가 맞는데 401이 나오는 이유는 무엇인가요?

BroadNet에서 401은 키가 틀렸거나 만료된 경우뿐 아니라, 종량제 사용 가능 금액이 소진되었거나 예산이 차단된 경우도 포함합니다. 계정 페이지에서 계정 잔액과 키 상태를 확인하세요.

### 여기서 401과 403은 어떻게 다른가요?

401은 키나 계정의 사용 가능 금액 문제입니다. 403은 키는 유효하지만 모델, 경로 또는 IP 정책이 요청을 거부했다는 뜻입니다. 예를 들어 허용 목록에 없는 주소에서 호출한 경우입니다.

### OpenAI SDK는 오류를 자동으로 재시도하나요?

네. OpenAI Python SDK는 기본적으로 연결 오류, 408, 409, 429, 5xx를 짧은 지수 백오프로 두 번 재시도합니다. 횟수를 바꾸려면 max\_retries를 설정하고, 재시도를 끄려면 0으로 지정하세요.

## 관련 가이드

-   [채팅 완성 스트리밍과 끊긴 연결 처리하기](https://broadrouter.com/ko/guides/streaming-chat-completions/)
-   [IP 허용 목록으로 API 키를 내 서버에만 묶기](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)
-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/)

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-errors-and-retries&utm_content=page-cta) ·

**출처**

-   [BroadNet Inference API 레퍼런스, 오류와 재시도 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-errors-and-retries&utm_content=sources#errors)
-   [BroadNet Inference API 레퍼런스, 한도 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-errors-and-retries&utm_content=sources#limits)
-   [OpenAI Python SDK README, 재시도와 타임아웃(2026-11-14 확인)](https://github.com/openai/openai-python#retries)
