---
title: "Mã lỗi API LLM 401, 402, 409, 429: khi nào thử lại | BroadRouter"
description: "Ý nghĩa từng mã trạng thái HTTP của BroadNet Inference API, lỗi nào nên thử lại với backoff, lỗi nào cần sửa trước và gửi gì cho bộ phận hỗ trợ kèm request ID."
url: https://broadrouter.com/vi/guides/errors-and-retries/
lang: vi
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/errors-and-retries/) (cập nhật ngày 2026-11-14).

# Mã lỗi BroadNet Inference và khi nào nên thử lại

Cập nhật 2026-11-14

Hãy kiểm tra mã trạng thái HTTP trước khi parse body. Thử lại 429 và 5xx bằng exponential backoff có giới hạn. Sửa 400, 403, 413 và 422 rồi mới thử lại. Gặp 401 thì kiểm tra key và số dư, gặp 402 thì nạp tiền vào tài khoản. Luôn ghi log header X-Request-ID để gửi bộ phận hỗ trợ.

API trả về mã trạng thái HTTP thông thường kèm một mã lỗi dành cho máy đọc. Hãy dựa vào mã trạng thái để quyết định bước tiếp theo. Bảng dưới đây theo [tài liệu tham chiếu API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-errors-and-retries&utm_content=body#errors) của BroadNet.

| Mã trạng thái | Ý nghĩa | Cần làm gì |
| --- | --- | --- |
| 400 / 422 | Request hoặc trường không hợp lệ | Sửa request trước |
| 401 | Thiếu key, key không hợp lệ hoặc hết hạn, ngân sách trả theo mức dùng bị chặn, hoặc đã dùng hết hạn mức | Kiểm tra trạng thái key và số dư tài khoản |
| 402 `insufficient_balance` | Tài khoản không đủ tiền cho một giao dịch mua; body có kèm số dư và giá | Nạp tiền vào tài khoản rồi thử lại |
| 403 | Bị từ chối do chính sách về model, route hoặc IP | Sửa chỗ không khớp, ví dụ [danh sách IP được phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/) |
| 409 | Xung đột với trạng thái tài khoản: `mint_in_progress`, `key_limit_reached`, `credential_limit_reached`, `key_pending` | Chỉ thử lại `mint_in_progress`, với cùng `request_id` |
| 413 | Request quá lớn; file chép lời tối đa 26.214.400 byte | Giảm kích thước request |
| 429 | Chạm giới hạn tần suất, đồng thời, token mỗi phút hoặc chi tiêu | Đọc chi tiết trong phản hồi, tạm dừng rồi thử lại |
| 500 / 502 / 503 / 504 | Sự cố xử lý phía server | Thử lại với exponential backoff có giới hạn; khi mua key theo giờ, dùng lại cùng `request_id` |

Tài liệu của BroadNet khuyên kiểm tra mã trạng thái HTTP trước khi parse body JSON, sau đó mới đọc mã `error` dành cho máy đọc nếu có.

## Những giới hạn nào gây ra lỗi 429?

Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý cùng lúc. Theo tài liệu của BroadNet, một key theo giờ được 120 request mỗi phút, một luồng và 300,000 token mỗi phút. Với [gói không giới hạn](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/), mỗi phiên xử lý một request tại một thời điểm. Để so sánh các giới hạn này với OpenAI, Anthropic, Groq và DeepSeek, hãy đọc [giới hạn tần suất API LLM theo từng nhà cung cấp](https://broadrouter.com/vi/blog/llm-api-rate-limits-by-provider/).

## Thử lại với OpenAI SDK như thế nào?

Theo [README trên GitHub](https://github.com/openai/openai-python#retries), OpenAI Python SDK vốn đã tự thử lại lỗi kết nối và các phản hồi 408, 409, 429 và 5xx hai lần theo mặc định, với exponential backoff ngắn. Timeout mặc định là 10 phút. Hãy đặt rõ cả hai giá trị. Trong ví dụ dưới, `max_retries` bằng 0 sẽ tắt việc tự động thử lại; `timeout` tính bằng giây, hãy tăng lên cho những câu trả lời suy luận dài.

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

## Tự viết backoff như thế nào?

Nếu bạn gọi API mà không dùng SDK, hãy giới hạn cả số lần thử lẫn thời gian chờ. Hàm dưới đây trả kết quả về ngay khi mã trạng thái không thuộc nhóm cần thử lại, tức là request đã thành công hoặc gặp lỗi cần sửa chứ không nên thử lại.

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

Đừng bao giờ thử lại nguyên trạng các lỗi 400, 403, 413 hay 422: cùng một request sẽ thất bại theo cùng một cách. Mỗi lần thử lại một request chat là một lượt inference mới và bị tính phí lại nếu bạn trả theo mức dùng. Xem [exponential backoff](https://broadrouter.com/vi/glossary/exponential-backoff/) để biết mẫu chung.

## Thử lại an toàn khi mua key theo giờ

`POST /portal/keys/hourly` nhận một `request_id`. Sau khi bị timeout, mất kết nối, gặp 409 `mint_in_progress` hoặc 5xx, hãy thử lại với **cùng** `request_id`. Một `request_id` được dùng lại không bao giờ tạo hay tính phí key thứ hai; lần gửi lại sẽ trả về `already_issued: true` cùng alias của key. Đừng tạo id mới khi chưa biết kết quả của lần đầu. Đọc thêm về [idempotency key](https://broadrouter.com/vi/glossary/idempotency-key/).

## Xử lý sự cố

-   **401 ngay sau khi nạp tiền.** Trang tài khoản BroadNet hiển thị hạn mức được ghi nhận gần nhất và đánh dấu thay đổi về nạp tiền là đang cập nhật trong lúc áp dụng. Hãy tải lại trang và thử lại khi quá trình này đã xong.
-   **429 dù chỉ gửi vài request mỗi phút.** Nhiều khả năng bạn đang chạm giới hạn 4 request đồng thời, ví dụ khi chạy song song nhiều stream dài. Hãy dùng một worker pool nhỏ.
-   **403 với một model nhưng model khác thì không.** Chính sách của key không bao gồm model hoặc route đó. Ví dụ, key của gói dành cho `broadnet/deepseek-v4.1-flash`, còn key theo giờ chỉ dùng được với `broadnet/gemma-4-26b-a4b`.
-   **SDK tự thử lại và bạn bị tính phí hai lần.** Một request chat được thử lại là một lượt inference mới. Hãy đặt `max_retries=0` ở những chỗ mà một câu trả lời trùng lặp tốn kém hơn một lần thất bại.

## Gửi gì cho bộ phận hỗ trợ

Hãy gửi giá trị header `X-Request-ID`, thời điểm theo UTC, route, mã trạng thái HTTP và alias của key. Tuyệt đối không gửi chính key. [Hướng dẫn OpenAI Python SDK](https://broadrouter.com/vi/guides/openai-python-sdk/) chỉ cách đọc header này.

## Thuật ngữ trong hướng dẫn này

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

[Exponential backoff (lùi thời gian theo cấp số nhân)](https://broadrouter.com/vi/glossary/exponential-backoff/)

Exponential backoff là chiến lược thử lại trong đó client chờ lâu hơn sau mỗi lần thất bại trước khi thử tiếp, thường nhân đôi độ trễ cho tới một mức trần. Thêm jitter ngẫu nhiên vào mỗi lần chờ giúp dàn trải các lần thử lại từ nhiều client để chúng không đổ dồn vào server cùng lúc.

[Idempotency key (khóa idempotency)](https://broadrouter.com/vi/glossary/idempotency-key/)

Idempotency key là một giá trị duy nhất, thường là ID ngẫu nhiên như UUID, mà client gắn vào request làm thay đổi trạng thái, chẳng hạn thanh toán hay mua hàng. Nếu cùng request được gửi lại với cùng key, server trả về kết quả ban đầu thay vì thực hiện hai lần.

[IP allow list (danh sách IP được phép)](https://broadrouter.com/vi/glossary/ip-allow-list/)

IP allow list là cơ chế bảo mật chỉ chấp nhận request từ các địa chỉ IP hoặc dải CIDR trong danh sách và từ chối mọi nguồn khác. Trên API, nó hạn chế thiệt hại khi key bị lộ, vì key không hoạt động từ các mạng không có trong danh sách.

[Token](https://broadrouter.com/vi/glossary/token/)

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

[Gói LLM giá cố định (flat-rate LLM plan)](https://broadrouter.com/vi/glossary/flat-rate-llm-plan/)

Gói LLM giá cố định tính một mức giá cố định cho mỗi kỳ, ví dụ một tháng, để dùng API mô hình ngôn ngữ thay vì tính theo token. Gói này thường giới hạn thứ khác, như số request đồng thời, tốc độ, model hay khung giờ sử dụng, nên giới hạn quan trọng không kém giá.

## Câu hỏi thường gặp

### API LLM trả lỗi 429 thì có nên thử lại không?

Có, nhưng hãy dùng exponential backoff có giới hạn. Trên BroadNet Inference, 429 nghĩa là bạn đã chạm giới hạn tần suất, số request đồng thời, token mỗi phút hoặc giới hạn chi tiêu. Nếu lỗi lặp lại liên tục, hãy giảm mức song song; còn nếu nguyên nhân là giới hạn chi tiêu thì dừng thử lại.

### Vì sao key đúng mà vẫn bị lỗi 401?

Trên BroadNet, 401 không chỉ là key sai hoặc hết hạn, mà còn bao gồm trường hợp đã dùng hết hạn mức trả theo mức dùng hoặc ngân sách bị chặn. Hãy kiểm tra số dư tài khoản và trạng thái key trên trang tài khoản.

### Ở đây 401 và 403 khác nhau thế nào?

401 liên quan đến key hoặc hạn mức của tài khoản. 403 nghĩa là key vẫn hợp lệ nhưng request bị từ chối do chính sách về model, route hoặc IP, ví dụ một lệnh gọi từ địa chỉ không nằm trong danh sách IP được phép.

### OpenAI SDK có tự động thử lại khi gặp lỗi không?

Có. Theo mặc định, OpenAI Python SDK thử lại lỗi kết nối, 408, 409, 429 và 5xx hai lần với exponential backoff ngắn. Đặt max\_retries để đổi số lần, hoặc đặt bằng 0 để tắt việc thử lại.

## Hướng dẫn liên quan

-   [Streaming chat completions và xử lý khi mất kết nối](https://broadrouter.com/vi/guides/streaming-chat-completions/)
-   [Khóa API key vào server của bạn bằng danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/)
-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-errors-and-retries&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu tham chiếu BroadNet Inference API, lỗi và thử lại (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-errors-and-retries&utm_content=sources#errors)
-   [Tài liệu tham chiếu BroadNet Inference API, giới hạn (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-errors-and-retries&utm_content=sources#limits)
-   [README của OpenAI Python SDK, thử lại và timeout (kiểm tra ngày 2026-11-14)](https://github.com/openai/openai-python#retries)
