Developer guide
Mã lỗi
Cách xử lý và quy tắc thử lại theo mã trạng thái
Cổng giao tiếp sẽ chuyển tiếp nguyên mã đó nếu upstream trả về 4xx·5xx; trong các trường hợp khác, hãy tuân theo quy tắc trong bảng dưới đây.
400·401·403·404·413 là các mã yêu cầu sửa yêu cầu hoặc cấu hình, còn 409·429·5xx là các mã mà máy khách cần chờ rồi gửi lại cùng yêu cầu.
Định dạng nội dung lỗi khác nhau tùy theo đặc tả, và error.type của đường dẫn tương thích với Anthropic được xác định theo mã trạng thái.
Lý do của 403 được phân biệt qua error.message, còn các số liệu về hạn mức và mức sử dụng được kiểm tra trên màn hình bảng điều khiển.
Mã trạng thái
| Mã | Ý nghĩa | Cách xử lý |
|---|---|---|
| 400 | Giá trị yêu cầu không hợp lệ. limit của danh sách mô hình tương thích với Anthropic nằm ngoài phạm vi 1~1000 hoặc bạn đã cố tiếp tục phát trực tuyến một phản hồi đã lưu bằng GET /responses/{responseId}?stream=true. | Hãy sửa giá trị để nằm trong phạm vi cho phép. Hãy truy vấn phản hồi đã lưu mà không dùng stream. |
| 401 | Khóa bị thiếu, hết hạn hoặc đã bị thu hồi. | Kiểm tra trạng thái khóa trên màn hình API key, đồng thời kiểm tra tên tiêu đề và tiền tố Bearer. |
| 403 | Bạn không có quyền truy cập mô hình, đã vượt quá hạn mức sử dụng, không đủ tín dụng hoặc không phải chủ sở hữu giọng nói. | Kiểm tra lý do trong error.message; kiểm tra các con số trên màn hình trong phần hạn mức và mức sử dụng bên dưới. |
| 404 | Mô hình không tồn tại hoặc không thể truy cập bằng khóa này (bao gồm cả các mô hình đã ngừng được hỗ trợ). Lỗi này cũng được trả về khi bạn gọi đường dẫn không tồn tại hoặc yêu cầu sản phẩm CleviDrive đã quá thời hạn lưu giữ 3 ngày. | Trước tiên, hãy kiểm tra danh sách mô hình có thể gọi bằng GET /models. Đối chiếu đường dẫn với bảng trên trang Gọi API. |
| 408 · 409 · 413 | Đã xảy ra hết thời gian chờ upstream, tắc nghẽn hoặc yêu cầu vượt quá kích thước cho phép. Thời gian chờ của các đường dẫn âm thanh và giọng nói là 5 phút, giới hạn yêu cầu là 28 MiB. | Nếu 409 có Retry-After, hãy đợi trong khoảng thời gian đó rồi gửi lại cùng một yêu cầu. Với 413, hãy chia nhỏ yêu cầu để gửi. |
| 429 | Nhà cung cấp upstream đã áp dụng giới hạn tốc độ. | Nếu có Retry-After, hãy đợi trong khoảng thời gian đó rồi thử lại; nếu không có, hãy thử lại với thời gian chờ tăng theo cấp số nhân. |
| 5xx | Lỗi tạm thời từ gateway hoặc upstream (bao gồm 503). | Hãy thử lại với thời gian chờ tăng theo cấp số nhân. Nếu lỗi tiếp diễn, hãy liên hệ hỗ trợ. |
Không trả về 402. Thiếu tín dụng và vượt quá hạn mức sử dụng đều được trả về dưới dạng 403.
Thử lại và liên hệ hỗ trợ
Gateway không tự tạo 429, cũng không tự thử lại hoặc đưa phản hồi upstream vào hàng đợi. Việc chờ và thử lại do client thực hiện.
Khi liên hệ hỗ trợ, hãy cung cấp thông tin cùng với X-Request-Id qua mục Trợ giúp và liên hệ. Nếu bạn không gửi X-Request-Id, giá trị do máy chủ cấp nằm trong tiêu đề request-id của phản hồi tương thích với Anthropic.
Nội dung lỗi
Định dạng nội dung lỗi khác nhau tùy theo đặc tả. Đối với lỗi từ upstream, chỉ giữ lại và truyền thông báo; không truyền stack hoặc các trường nội bộ.
Nội dung lỗi của đường dẫn tương thích với OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Nội dung lỗi của đường dẫn tương thích với Anthropic. error.type được xác định theo mã trạng thái như trong bảng dưới đây.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Mã trạng thái | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Mã khác | api_error |
Kiểm tra hạn mức và mức sử dụng
Các chỉ số hạn mức khác nhau tùy theo workspace. Sau khi kiểm tra lý do của lỗi 403 trong error.message, hãy kiểm tra các chỉ số trên màn hình sau.
| Mục cần kiểm tra | Màn hình console |
|---|---|
| Hạn mức áp dụng cho workspace | Hạn mức sử dụng được phân bổ trong phần Tổng quan |
| Phạm vi và số dư được gói cước cho phép | Gói cước và credit |
| Mức sử dụng thực tế (số lần gọi theo model và key, credit dự kiến bị trừ) | Mức sử dụng |
| Trạng thái key (đã hết hạn hoặc bị thu hồi) | API key |