Khắc phục sự cố

Hãy xử lý theo triệu chứng khớp với những gì bạn đang thấy. Trong hầu hết các trường hợp, tab Logs là công cụ chẩn đoán nhanh nhất — tab này hiển thị trạng thái của từng yêu cầu và kiểu lỗi (một khóa? một mô hình? tất cả?). Xem Hoạt động và nhật ký.

Yêu cầu bị chặn

Mọi yêu cầu đều thất bại với lỗi 402 insufficient_credits

Nguyên nhân: mô-đun chưa được bật cho cơ sở này, hoặc số dư trả trước đã cạn (tab Overview sẽ hiển thị "Your balance is depleted. Inference requests will be blocked until you top up."). Đối với khóa API, cơ sở chưa bật Model Router sẽ trả về lỗi 403 "Model Router is not enabled for this facility".

Cách khắc phục: bật Model Router từ trang Welcome to Model Router (xem Bắt đầu), sau đó nạp tiền tại Budgets & Limits → Balance & Top-up. Yêu cầu sẽ hoạt động trở lại ngay sau khi số dư được cộng. Để tránh tái diễn, hãy bật tự động nạp tiền. Xem Ngân sách và nạp tiền.

Yêu cầu thất bại với lỗi 402 budget_exceeded

Nguyên nhân: đã đạt đến một hạn mức chi tiêu. Thông báo lỗi cho biết khoảng thời gian nào (hằng ngày / hằng tháng / trọn đời) và — đối với hằng ngày và hằng tháng — chính xác thời điểm hạn mức được đặt lại theo múi giờ của cơ sở. Đó có thể là hạn mức trên toàn tài khoản hoặc hạn mức của một khóa hay dịch vụ được kết nối cụ thể (thông báo sẽ ghi "This key's" / "This agent's" khi hạn mức áp dụng theo phạm vi).

Cách khắc phục: chờ đến thời điểm đặt lại đã nêu, nâng hạn mức (Budgets & Limits → Spend Limits, hoặc trong cấu hình của khóa hay dịch vụ), hoặc — đối với giới hạn cứng trọn đời — sử dụng Reset hard cap. Trang Spend Limits cho biết chính xác những hạn mức nào đang ở trạng thái "Limit reached".

Yêu cầu thất bại với lỗi 403 content_policy_violation

Nguyên nhân: lời nhắc khớp với một bộ lọc nội dung ở chế độ block hoặc lá chắn chống chèn lời nhắc (prompt injection).

Cách khắc phục: xem lại Settings → Guardrails. Nếu một tích hợp thực sự cần quy tắc khác, hãy dùng nút bật/tắt Override facility guardrails của tích hợp đó thay vì nới lỏng chính sách trên toàn cơ sở. Xem Guardrails.

Yêu cầu thất bại với lỗi 429

Nguyên nhân: khóa hoặc dịch vụ được kết nối đã vượt quá giới hạn tốc độ Requests / min hoặc Tokens / min.

Cách khắc phục: giảm tần suất và thử lại, hoặc nâng giới hạn tốc độ trong cấu hình của khóa hoặc dịch vụ (để trống = không giới hạn). Xem Khóa API.

Một mô hình cụ thể trả về lỗi, các mô hình khác vẫn hoạt động

Nguyên nhân: mô hình có thể đã bị tắt cho cơ sở của bạn, bị loại trừ bởi giới hạn mô hình của khóa, hoặc nhà cung cấp đang gặp sự cố.

Cách khắc phục: kiểm tra Settings → Models (mô hình có được bật không?), danh sách Restrict models của khóa, và Activity → Performance → Reliability & performance by model để xem tỷ lệ lỗi của mô hình theo thời gian.

Sự cố khóa API

401 Unauthorized

Nguyên nhân: với mã invalid_api_key ("Missing or invalid API key"), header Authorization: Bearer … bị thiếu hoặc sai định dạng. Khi không có mã ("Invalid API key"), khóa không được nhận diện (gõ sai, hoặc là mã bí mật cũ sau khi rotate) hoặc đã bị revoked.

Cách khắc phục: xác nhận định dạng header; kiểm tra trạng thái của khóa trong Settings → Service Access & API Keys. Kích hoạt lại khóa đã bị thu hồi, hoặc cập nhật dịch vụ của bạn sang mã bí mật mới nếu khóa đã được xoay vòng.

Tôi bị mất mã bí mật của khóa

Mã bí mật chỉ hiển thị một lần khi tạo và không thể khôi phục. Hãy dùng Rotate — một mã bí mật mới được cấp (chỉ hiển thị một lần) và khóa vẫn giữ nhãn, hạn mức và lịch sử. Cập nhật mọi dịch vụ đang dùng khóa này: "You will need to reconfigure any services still using the old key."

Khóa hoạt động nhưng mức sử dụng hiển thị dưới tên sai

Khóa được nhận diện bằng Label trong Activity và Logs. Hãy chỉnh sửa khóa và đặt một nhãn có ý nghĩa; cấp cho mỗi hệ thống một khóa riêng thay vì dùng chung một khóa.

Sự cố agent

Một agent hiển thị Ngoại tuyến

Nguyên nhân: thiết bị đã tắt nguồn hoặc mất kết nối — đây là vấn đề kết nối của thiết bị, không phải một cài đặt của Model Router.

Cách khắc phục: kiểm tra nguồn điện và mạng của thiết bị. Cấu hình truy cập của thiết bị không bị ảnh hưởng và sẽ hoạt động trở lại ngay khi thiết bị kết nối lại.

Một agent ngừng phản hồi các yêu cầu AI

Kiểm tra theo thứ tự:

1. Số dư — số dư cạn sẽ chặn tất cả agent (agent hiển thị trạng thái cần nạp tín dụng). Hãy nạp tiền.
2. Hạn mức theo dịch vụ — Settings → Service Access & API Keys → Connected Services: agent có hiển thị "Limit reached" không? Hãy nâng hạn mức hoặc chờ hạn mức được đặt lại.
3. Hạn mức tài khoản — Budgets & Limits → Spend Limits.
4. Logs — lọc theo agent để xem lỗi thực tế trên các yêu cầu của agent đó.

Câu hỏi về số dư và thanh toán

Số liệu chi tiêu có vẻ chậm cập nhật

Các số liệu Available balance và Spent today được cập nhật trực tiếp. Monthly usage được đối chiếu với số dư của bạn sau mỗi 15 phút, vì vậy khoản chi tiêu rất gần đây có thể mất vài phút mới xuất hiện ở đó. Lịch sử giao dịch chỉ liệt kê các lần nạp tiền và điều chỉnh số dư, vì vậy mức sử dụng không bao giờ xuất hiện trong đó.

Tự động nạp tiền không chạy

Kiểm tra trang Balance & Top-up để tìm biểu ngữ thông báo: chưa có thẻ được lưu, thẻ cần xác thực, hoặc thẻ bị từ chối. Hãy sửa thông tin thẻ (Update card / Edit payment details) hoặc nạp tiền thủ công. Việc kiểm tra tự động nạp tiền chạy khoảng 15 phút một lần, vì vậy một ngưỡng vừa bị vượt qua có thể mất vài phút mới kích hoạt.

Một lần nạp tiền thất bại

"Additional card authentication is required. Please try again." — hãy thử lại; ngân hàng của bạn có thể yêu cầu xác minh. "Top-up could not be completed." — giao dịch bị từ chối; hãy kiểm tra thẻ hoặc thử một số tiền khác. Không có tín dụng nào được cộng trừ khi giao dịch thành công.

Tôi đã bị trừ tiền nhưng số dư không thay đổi

Các lần nạp tiền được cộng ngay lập tức — hãy làm mới trang. Nếu số dư vẫn không phản ánh một giao dịch thành công, hãy ghi lại Transaction ID và Payment reference từ ngăn chi tiết của giao dịch (hoặc sao kê thẻ của bạn) và gửi yêu cầu hỗ trợ.

Câu hỏi về nhật ký và phân tích

Yêu cầu tôi vừa gửi chưa có trong Logs

Bật chế độ làm mới Live (hoặc nhấp Refresh now). Yêu cầu thường xuất hiện ngay lập tức; khi hệ thống tải cao, có thể mất lâu hơn một chút.

Logs hiển thị một mô hình tôi không yêu cầu

Nếu bạn gửi model: "auto", nhật ký sẽ hiển thị mô hình mà Auto Router đã chọn — mở chi tiết của yêu cầu để xem Requested model: auto. Đây là hành vi bình thường. Xem Mô hình.

Các hàng hiển thị "No charge"

Các phản hồi lỗi hoặc trống không tốn phí được gắn nhãn No charge — chúng được ghi lại cho đầy đủ nhưng không trừ vào số dư.

Tệp CSV xuất ra nhỏ hơn dự kiến

Bản xuất thô bị giới hạn ở 25,000 hàng — hãy thu hẹp khoảng ngày hoặc dùng bản xuất tóm tắt. Lưu ý thêm: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."