Tham chiếu

Lỗi

Lỗi trả về theo dạng của OpenAI, với một code ổn định để bạn đối chiếu và một message viết cho con người. Yêu cầu bị từ chối hoặc thất bại không tốn chi phí.

Đã kiểm tra 26 tháng 10, 2026

Cấu trúc

Response

{
  "error": {
    "type": "rate_limit_error",
    "code": "daily_cap",
    "message": "This call needs up to $0.02 and the key has $0.01 left of its $2.00 daily cap, which resets at 00:00 UTC. …"
  }
}

Khớp theo code, không theo message: message có thể được viết lại, còn code thì giữ nguyên. type theo chuẩn của OpenAI, nên các SDK sẽ ném ra đúng ngoại lệ bạn mong đợi.

Mọi mã

Trạng thái	Mã	Khi nào	Cách sửa
401	`missing_key`	Không có khóa nào được gửi.	Gửi khóa dưới dạng `Authorization: Bearer sk-nokeep-…`. Tạo khóa trong bảng điều khiển, hoặc thử `sk-nokeep-test` trước.
401	`invalid_key`	Khóa sai, hoặc đã bị thu hồi.	Sao chép lại khóa từ nơi bạn đã lưu; bảng điều khiển chỉ hiện bốn ký tự cuối. Nếu mất, hãy tạo khóa mới.
403	`account_frozen`	Các tính năng trả phí đang bị tạm dừng trên tài khoản sở hữu khóa này.	Hãy viết cho chúng tôi qua trang liên hệ.
429	`rate_limited`	Khóa đã gửi hơn 120 yêu cầu trong một phút (20 với khóa thử, theo mỗi địa chỉ).	Đợi số giây trong `Retry-After`, rồi thử lại.
429	`daily_cap`	Lệnh gọi có thể vượt giới hạn hằng ngày của khóa.	Tăng giới hạn trong bảng điều khiển, giảm `max_tokens`, hoặc đợi đến 00:00 UTC (`Retry-After` cho biết còn bao lâu).
402	`insufficient_credits`	Tín dụng đã mua trong tài khoản không đủ trả cho lệnh gọi này.	Nạp từ 5 $ trong bảng điều khiển, hoặc giảm `max_tokens`. Tín dụng của gói vẫn nằm trong ứng dụng.
400	`invalid_json`	Phần thân không phải là một đối tượng JSON.	Gửi `Content-Type: application/json` và một đối tượng JSON.
413	`too_large`	Yêu cầu lớn hơn 12 MB.	Gửi ảnh dưới dạng liên kết thay vì data URL, hoặc gửi ít ảnh hơn mỗi lần.
404	`model_not_found`	ID mô hình không phải của chúng tôi.	`GET /v1/models` liệt kê các ID. Kiểm tra lỗi gõ hoặc thiếu `-uncensored`.
400	`invalid_messages`	`messages` bị thiếu hoặc trống, quá dài, có role không xác định, hoặc có tin nhắn tool thiếu `tool_call_id`.	Gửi từ 1 đến 2.000 tin nhắn, mỗi tin có role là system, developer, user, assistant hoặc tool.
400	`unsupported_n`	`n` lớn hơn 1.	Gửi một yêu cầu cho mỗi câu trả lời bạn muốn.
400	`invalid_reasoning_effort`	Mô hình không nhận giá trị `reasoning_effort` đó.	DeepSeek nhận none, low, high hoặc max. GLM nhận low hoặc high.
400	`unsupported_tool_choice`	GLM nhận một hàm có tên hoặc "required" làm `tool_choice`.	Gửi auto hoặc none cho GLM; mô hình tự chọn tool. DeepSeek nhận mọi dạng.
400	`unsupported_input`	Một phần nội dung thuộc loại mà mô hình không đọc được.	Gửi ảnh cho DeepSeek; GLM chỉ đọc văn bản.
400	`too_many_images`	Hơn mười ảnh trong một yêu cầu.	Gửi tối đa mười ảnh.
422	`hard_limit`	Yêu cầu vượt qua một trong các giới hạn cứng trong điều khoản.	Không bị tính phí. Hãy bỏ tin nhắn đó khỏi lịch sử bạn gửi lại, nếu không lệnh gọi tiếp theo cũng sẽ dừng.
400	`rejected`	Mô hình không nhận được yêu cầu như đã gửi.	Đối chiếu các tham số với danh sách của mô hình trong Mô hình. Không bị tính phí.
503	`busy`	Mô hình đang bận.	Thử lại sau số giây trong `Retry-After`. Không bị tính phí.
503	`model_unavailable`	Mô hình đang ngoại tuyến phía chúng tôi.	Tạm dùng mô hình còn lại; trang trạng thái cho biết khi nào nó hoạt động lại.
502	`upstream_error`	Mô hình lỗi trước khi viết được chữ nào.	Thử lại sau giây lát. Không bị tính phí.
404	`not_found`	Đường dẫn không tồn tại.	API phục vụ `GET /v1/models`, `GET /v1/models/{id}`, `GET /v1/status` và `POST /v1/chat/completions`.
404	`api_closed`	API đang tắt.	Hãy thử lại sau.

Khi đang truyền	Mã	Khi nào	Cách sửa
—	`stream_cut`	Mô hình dừng trước khi xong, giữa lúc đang truyền.	Chỉ tính phí phần đã viết, không hơn. Thử lại để lấy phần còn lại, hoặc tiếp tục từ phần đã nhận.

Mã nào nên thử lại

Thử lại 429 rate_limited, 503 busy và 502 upstream_error, sau số giây trong Retry-After nếu có.
Đừng thử lại các lỗi 400, 401, 402, 404 hay 422: cùng một yêu cầu sẽ nhận cùng một kết quả.
429 daily_cap sẽ chờ đến 00:00 UTC. Hãy nâng giới hạn thay vì chờ.

Lấy khóa API Dùng thử khóa thử nghiệm miễn phí: sk-nokeep-test

Cấu trúc

Mọi mã

Mã nào nên thử lại

Bạn đang nghĩ gì?