> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Lỗi API thường gặp

> Chẩn đoán lỗi NexusAPI theo mã lỗi, giao thức và Request ID.

Trước hết lưu toàn bộ lỗi, Request ID, thời gian, mô hình và endpoint. Lỗi tham số, giao thức hoặc trạng thái phiên không tự hết khi gửi lại liên tục.

## `status_code=500, not implemented`

Với kênh Claude kiểu Anthropic được gọi bằng `/v1/responses`, đây là **không tương thích giao thức**, không phải lỗi tạm thời.

1. Ứng dụng tự viết dùng `/v1/chat/completions`.
2. Claude Code dùng cấu hình Messages trong [hướng dẫn Claude Code](/vi/tools/claude-code).
3. Không gửi lại nguyên yêu cầu đó.

## Mã HTTP

| Mã              | Nguyên nhân thường gặp                             | Việc đầu tiên                                         |
| --------------- | -------------------------------------------------- | ----------------------------------------------------- |
| 400             | Mô hình, endpoint, tham số hoặc phiên không hợp lệ | Kiểm tra giao thức và làm test tối thiểu ở phiên mới. |
| 401             | Key thiếu, sai, hết hạn hoặc bị vô hiệu            | Sao chép lại key và định dạng Bearer.                 |
| 403             | Nhóm, hạn chế, IP, tài khoản hoặc upstream từ chối | Kiểm tra thiết lập key.                               |
| 404             | Sai đường dẫn hoặc `/v1` bị lặp                    | Kiểm tra URL thực tế.                                 |
| 429             | Giới hạn tần suất hoặc đồng thời                   | Giảm đồng thời và theo `Retry-After`.                 |
| 500 / 502 / 503 | Lỗi xử lý hoặc upstream tạm thời                   | Chờ 10–30 giây, thử lại một lần.                      |
| 504 / 524       | Hết thời gian chờ                                  | Nếu phù hợp giảm ngữ cảnh/đầu ra, lưu Request ID.     |

## Các thông báo khác

* **`no available channel`**: nhóm của key không có tuyến đang bật cho mô hình. Kiểm tra ID chính xác, nhóm và Chợ mô hình; tạo key mới hay nạp thêm tiền không khắc phục điều này.
* **`Concurrency limit exceeded for user`**: chờ các yêu cầu hiện tại kết thúc và giảm mức đồng thời của client.
* **`Content block not found`**: hay gặp ở phiên dài, gọi công cụ hoặc stream bị ngắt. Xem [Content block not found](/vi/faq/content-block-not-found).
* **Lỗi/timeout ảnh**: kiểm tra mô hình, endpoint Images và tham số; không gửi lại ngay tác vụ ảnh giống hệt.

Nếu có chi phí bất thường, đối chiếu Request ID và nhật ký cùng thời gian. Không giả định nền tảng sẽ tự thử lại một yêu cầu thông thường.