Khắc phục sự cố
Chỉ mục theo triệu chứng — tìm tình trạng bạn đang gặp và chuyển đến nguyên nhân.
Kiểm tra quyền truy cập trước khi thử lại
- Kiểm tra xem quyền sử dụng dự kiến có đang hoạt động không và ghi lại thời điểm hết hạn.
- Xác nhận khóa sử dụng đúng nhóm dự kiến. Các gói Claude có thời hạn sử dụng Claude Unlimited; quyền truy cập Codex được cấp riêng.
- Liệt kê các mô hình bằng chính khóa đó, chọn một ID được trả về và gửi một yêu cầu nhỏ.
Sử dụng Mô hình và nhóm khóa hoặc danh sách kiểm tra thiết lập tác tử nếu bạn không chắc bước nào đã thất bại.
Không có gì hoạt động
Thiết lập trạng thái hoạt động cơ bản trước khi gỡ lỗi bất kỳ vấn đề nào khác:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Sau khi nhận được phản hồi liệt kê mô hình thành công, kiểm tra mô hình đã chọn có nằm trong danh sách hay không và gửi một yêu cầu tạo nội dung nhỏ. Việc tạo nội dung vẫn có thể thất bại do tình trạng khả dụng của mô hình, quyền sử dụng, giới hạn hoặc cấu hình máy khách.
Theo triệu chứng
| Dấu hiệu | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
404 trong mỗi lần gọi | URL cơ sở có cách xử lý sai đối với /v1 cách xử lý | URL cơ sở |
401 với khóa bạn vừa tạo | Header không đúng với định dạng, hoặc có dấu cách ở cuối | Xác thực |
402 | Không còn số dư, hoặc gói đã hết hạn | Nạp tiền · Gói dịch vụ |
400 max_tokens | Messages yêu cầu max_tokens; Chat Completions thì không | Messages |
model_not_found | Sai ID, sai nhóm khóa, hoặc mô hình không khả dụng với khóa đó | Mô hình và nhóm khóa |
| Kết nối truyền phát được thiết lập nhưng không trả về gì | Đang phân tích cấu trúc sự kiện của định dạng khác | Truyền dữ liệu theo luồng |
| Phản hồi bị cắt giữa câu | stop_reason: max_tokens | Tăng max_tokens |
| Hoạt động với curl nhưng thất bại với SDK | SDK nối đường dẫn riêng vào URL cơ sở của bạn | URL cơ sở |
| Mức sử dụng không hiển thị trên bảng điều khiển | Yêu cầu đang được gửi bằng khóa khác hoặc đến điểm cuối khác | Kiểm tra ANTHROPIC_API_KEY chưa được đặt — Claude Code |
Thường xuyên gặp 429 | Mức độ chạy song song của tác tử quá cao | Giới hạn tốc độ |
| Hóa đơn cao hơn dự kiến | Ngữ cảnh tăng dần qua các lượt | Quản lý ngữ cảnh |
Đọc nội dung lỗi
Mã trạng thái cho biết loại vấn đề; các trường error.type và error.message cho biết vấn đề cụ thể. Ghi lại toàn bộ nội dung — một 400 bằng "missing max_tokens" và một 400 bằng "invalid role" cần những cách khắc phục hoàn toàn khác nhau.
Vẫn chưa giải quyết được
Liên hệ support@aiprimetech.io kèm theo điểm cuối, ID mô hình, mã trạng thái và nội dung lỗi. Tuyệt đối không gửi kèm khóa API của bạn — nếu bạn đã dán khóa ở đâu đó, hãy thu hồi khóa trước.