Lỗi thường gặp & Cách khắc phục

Gặp báo lỗi thì đừng hoảng — dưới đây phân loại theo "thông báo bạn nhìn thấy", mỗi mục đều nêu nguyên nhân và bạn nên làm gì. Dùng Ctrl/⌘ + F trên trình duyệt để tìm từ khóa là nhanh nhất.

• 401 / invalid token / token không hợp lệ
• Số dư không đủ / insufficient quota / INSUFFICIENT_BALANCE
• Không có kênh khả dụng / Không có kênh khả dụng trong nhóm hiện tại / no available channel
• Mô hình không tồn tại / model_not_found
• Đứt luồng / stream disconnected / Connection error / Tải cao
• Yêu cầu hết thời gian chờ / timeout
• reasoning / cường độ suy nghĩ không có tác dụng
• Trang bảng điều khiển báo 500 / màn hình trắng / bấm đâu cũng lỗi
• Vẫn không xử lý được?

401 / invalid token / token không hợp lệ

Nguyên nhân: vấn đề ở API Key (token). Phần lớn là vì:

• Sao chép Key bị sai (thừa khoảng trắng, thiếu ký tự)
• Key đã bị xóa hoặc vô hiệu hóa trong bảng điều khiển
• Điền sai vị trí trong ứng dụng khách, hoặc thiếu Bearer

Cách làm:

1. Quay lại Bảng điều khiển → Token để xác nhận token này vẫn còn và trạng thái bình thường.
2. Sao chép lại một lần nữa, thay thế toàn bộ đoạn, lưu ý đầu cuối không dính khoảng trắng.
3. Xác nhận base_url cũng đã điền đúng (xem hướng dẫn của từng ứng dụng khách).

Số dư không đủ / insufficient quota / INSUFFICIENT_BALANCE

Nguyên nhân: số dư tài khoản hoặc hạn mức của token này đã hết.

Cách làm: vào Bảng điều khiển để nạp tiền; hoặc kiểm tra xem token này có đặt giới hạn hạn mức hay không, nếu có thì chỉ cần nâng lên.

Nạp tiền chưa vào tài khoản?

Nạp USDT / tiền mã hóa bắt buộc phải thanh toán đúng chính xác số tiền hiển thị trên trang (trả thừa hay trả thiếu đều không tự động ghi nhận). Nếu trả nhầm thì đừng lo, chụp màn hình lịch sử thanh toán và liên hệ chăm sóc khách hàng để được xử lý thủ công.

Không có kênh khả dụng / Không có kênh khả dụng trong nhóm hiện tại / no available channel

Nguyên nhân: mô hình bạn yêu cầu không có kênh tương ứng trong nhóm mà tài khoản của bạn thuộc về. Thường gặp khi điền tên một mô hình mà chúng tôi chưa cung cấp, hoặc không nằm trong gói của bạn.

Cách làm:

1. Mở Bảng điều khiển để xem danh sách mô hình khả dụng hiện tại, chọn một mô hình có trong đó.
2. Xác nhận tên mô hình viết hoàn toàn giống nhau (chữ hoa chữ thường, dấu gạch ngang đều phải đúng).
3. Đã xác nhận đúng mà vẫn báo lỗi → có thể là vấn đề quyền của nhóm bạn, liên hệ chăm sóc khách hàng để xác nhận.

Mô hình không tồn tại / model_not_found

Nguyên nhân: tên mô hình viết sai, hoặc mô hình đó không nằm trong nhóm của bạn.

Cách làm: giống như mục trên — vào bảng điều khiển, đối chiếu với danh sách mô hình, điền tên không sai một chữ nào vào ứng dụng khách.

Đứt luồng / stream disconnected / Connection error / Tải cao

Nguyên nhân:

• Nguồn cung cấp bận vào giờ cao điểm, hoặc mạng dao động tức thời
• Kết nối trực tiếp từ Trung Quốc đến máy chủ ở Đức, đường truyền đôi khi không ổn định

Cách làm:

1. Thử lại trực tiếp một lần, đa số đều thành công.
2. Xảy ra thường xuyên → đổi sang một mô hình khác thử (mô hình khác nhau đi qua nguồn cung cấp khác nhau).
3. Vẫn không được → chụp màn hình liên hệ chăm sóc khách hàng, chúng tôi sẽ kiểm tra trạng thái kênh ở hệ thống.

Yêu cầu hết thời gian chờ / timeout

Nguyên nhân: phần lớn là vấn đề mạng, đặc biệt khi kết nối trực tiếp từ Trung Quốc ra nước ngoài.

Cách làm: thử lại; nếu lâu dài vẫn chậm, khuyến nghị bật phần mềm tăng tốc / dùng proxy rồi mới kết nối.

reasoning / cường độ suy nghĩ không có tác dụng

Nguyên nhân: hai bộ giao diện có cách viết khác nhau, dùng lẫn lộn sẽ bị bỏ qua.

Giao diện	Cách viết đúng
/v1/chat/completions	Chuỗi: "reasoning_effort": "high"
/v1/responses (Codex v.v.)	Đối tượng: "reasoning": { "effort": "high" }

Cách làm: chọn cách viết tương ứng theo giao diện bạn dùng. Trong Codex chỉ cần dùng trực tiếp tùy chọn cấu hình model_reasoning_effort, không cần viết tay.

Trang bảng điều khiển báo 500 / màn hình trắng / bấm đâu cũng lỗi

Nguyên nhân: trình duyệt đang bật Google Dịch (tự động dịch toàn trang) sẽ xung đột với bảng điều khiển, khiến việc bấm vào trang bị báo lỗi.

Cách làm:

1. Tắt Google Dịch cho trang này (biểu tượng dịch trên thanh địa chỉ → hiển thị bản gốc), rồi làm mới là được.
2. Chúng tôi đã thêm cơ chế bảo vệ ở phía máy chủ, nhưng vẫn khuyến nghị không bật dịch toàn trang khi duyệt các bảng điều khiển loại này.

Đã biết và đã gia cố

Vấn đề này chúng tôi đã xử lý tương thích. Nếu sau khi cập nhật bạn vẫn gặp, tắt dịch rồi làm mới một lần về cơ bản là ổn.

Vẫn không xử lý được?

Gửi cho chăm sóc khách hàng ảnh chụp màn hình nguyên văn báo lỗi + ứng dụng khách và mô hình bạn đang dùng, sẽ nhanh hơn nhiều so với mô tả bằng lời.