> ## 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.

# Tự kiểm tra

> Lưu thông tin cần thiết và khoanh vùng lỗi NexusAPI trước khi liên hệ hỗ trợ.

Phần lớn lỗi cấu hình hoặc sự cố tạm thời có thể được khoanh vùng trong vài phút. Hãy lưu bằng chứng trước, sau đó chỉ thực hiện một kiểm tra tối thiểu với tần suất thấp.

## 1. Lưu bằng chứng

Trước khi đóng client hoặc thử lại, lưu:

* toàn bộ lỗi và Request ID;
* thời gian và múi giờ;
* model ID, endpoint, có streaming hay không;
* client / SDK và phiên bản.

Không gửi API Key đầy đủ, mật khẩu, dữ liệu riêng tư hoặc toàn bộ nội dung nghiệp vụ.

## 2. Xác định loại lỗi

| Hiện tượng             | Kiểm tra trước                                                     |
| ---------------------- | ------------------------------------------------------------------ |
| 401                    | Key, tiền tố `Bearer`, URL.                                        |
| 403                    | Nhóm, giới hạn mô hình, danh sách IP, tài khoản, từ chối upstream. |
| 404                    | Base URL, đường dẫn, `/v1` bị lặp hoặc thiếu.                      |
| 400                    | Mô hình, giao thức, tham số, trạng thái phiên.                     |
| 429                    | Đồng thời và tần suất; theo `Retry-After`.                         |
| 500 / 502 / 503        | Chờ 10–30 giây rồi chỉ thử lại một lần.                            |
| 504 / 524              | Kích thước yêu cầu, thời gian chờ, trạng thái dịch vụ.             |
| `500, not implemented` | Không thử lại; kiểm tra có gọi Claude qua Responses hay không.     |
| `no available channel` | Model ID, nhóm token, khả năng hiện tại.                           |

Xem chi tiết tại [lỗi API thường gặp](/vi/faq/common-errors).

## 3. Làm kiểm tra tối thiểu

1. Xác nhận số dư và trạng thái key trong console.
2. Sao chép lại model ID từ Chợ mô hình.
3. Mở phiên mới và gửi văn bản ngắn.
4. Chỉ thử lại tối đa một lần và lưu Request ID mới.
5. Kiểm tra bản ghi tương ứng trong nhật ký.

Nếu phiên mới thành công, lỗi có thể nằm ở lịch sử hoặc nội dung ban đầu. Nếu kiểm tra tối thiểu vẫn thất bại, gửi thông tin:

```text theme={"system"}
Thời gian (kèm múi giờ):
Request ID:
Client và phiên bản:
Mô hình:
Endpoint:
Toàn bộ lỗi:
Ngắt quãng hay liên tục:
Đã thử trong phiên mới:
```

Nếu cần nhận diện key, chỉ cung cấp tối đa sáu ký tự cuối.