Khắc phục lỗi DeepSeek API 402: Insufficient Balance (Số dư không đủ)

beginner🧠 AI Tools2026-05-17| Bất kỳ môi trường nào sử dụng DeepSeek API (Python, Node.js, cURL, Go) thông qua api.deepseek.com

Error Message

{"error": {"message": "Insufficient Balance", "type": "insufficient_balance", "param": null, "code": "invalid_request_error"}}
#deepseek#api-error#billing#python

Vấn đềBot hoặc script của bạn đang chạy bỗng nhiên dừng hoạt động. Thay vì nhận được phản hồi từ AI, log của bạn lại xuất hiện hàng loạt lỗi HTTP 402. Điều này xảy ra vì DeepSeek-V3 và DeepSeek-R1 yêu cầu số dư tài khoản dương để hoạt động. Nếu tài khoản của bạn về 0, API sẽ ngắt quyền truy cập ngay lập tức.

Thông báo lỗi chi tiết```

{ "error": { "message": "Insufficient Balance", "type": "insufficient_balance", "param": null, "code": "invalid_request_error" } }


## Tại sao yêu cầu của bạn bị thất bạiDeepSeek sử dụng **mô hình thanh toán trả trước**. Không giống như AWS hay Google Cloud (thường thanh toán vào cuối tháng), DeepSeek yêu cầu bạn phải mua tín dụng (credits) trước. Thậm chí nếu bạn còn một phần nhỏ tiền lẻ, API vẫn sẽ báo lỗi nếu chi phí ước tính cho prompt tiếp theo vượt quá số dư còn lại.
Các nguyên nhân phổ biến gây ra lỗi này bao gồm:
- **Sử dụng Token cao:** DeepSeek-V3 rất rẻ (khoảng $0.14 cho mỗi 1 triệu input tokens), nhưng các ứng dụng có lưu lượng lớn vẫn có thể làm cạn kiệt số dư nhỏ một cách nhanh chóng.- **Gói dùng thử hết hạn:** Các tài khoản mới thường nhận được $2–$5 tín dụng dùng thử miễn phí. Những khoản này thường hết hạn sau vài tháng, bất kể bạn có sử dụng chúng hay không.- **Không có tính năng tự động nạp tiền:** DeepSeek hiện chưa có tính năng tự động nạp tiền (auto-reload), nghĩa là bạn phải nạp tiền thủ công trước khi số dư cạn kiệt.## Cách khắc phục nhanh: Nạp tiền thủ côngĐể đưa ứng dụng hoạt động trở lại, bạn cần nạp thêm tiền vào tài khoản nhà phát triển. Thông thường sẽ mất chưa đầy hai phút để số dư được cập nhật.
- Đăng nhập vào [DeepSeek Platform](https://platform.deepseek.com/).- Nhấp vào **Top up** ở thanh bên.- Kiểm tra số dư hiện tại. Nếu hiển thị $0.00, bạn đã tìm ra nguyên nhân.- Chọn số tiền nạp. Mức tối thiểu thường là $2.00.- Thanh toán qua Stripe, PayPal hoặc thẻ tín dụng.- Chờ khoảng 60 giây, sau đó tải lại trang để xác nhận số dư mới.## Tối ưu code: Xử lý lỗi 402 một cách chuyên nghiệpViệc toàn bộ ứng dụng bị sập chỉ vì lỗi thanh toán là một trải nghiệm tệ cho người dùng. Thay vào đó, hãy bắt lỗi 402 và kích hoạt cảnh báo để bạn có thể xử lý trước khi người dùng nhận ra.
### Ví dụ Python (OpenAI SDK)DeepSeek hoàn toàn tương thích với thư viện Python của OpenAI. Sử dụng cấu trúc sau để bắt các lỗi liên quan đến thanh toán:

import openai from openai import OpenAI

client = OpenAI(api_key="YOUR_DEEPSEEK_API_KEY", base_url="https://api.deepseek.com")

def safe_chat_request(prompt): try: return client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": prompt}] ) except openai.APIStatusError as e: if e.status_code == 402: # Kích hoạt cảnh báo nội bộ (Slack, PagerDuty, hoặc Email) print("CẢNH BÁO THANH TOÁN: Số dư DeepSeek đã hết!") return "Dịch vụ AI của chúng tôi hiện đang tạm nghỉ. Vui lòng thử lại sau 5 phút." raise e except Exception as e: print(f"Lỗi chung: {e}") return None


## Giám sát và Phòng ngừaVì DeepSeek chưa cung cấp tính năng tự động nạp tiền, bạn cần phải chủ động. Hãy kiểm tra bảng điều khiển **Usage** hàng tuần để theo dõi tốc độ tiêu thụ tiền. Nếu ứng dụng của bạn chi tiêu $0.50 mỗi ngày, hãy duy trì ít nhất $15 trong tài khoản để đảm bảo dịch vụ không bị gián đoạn trong cả tháng.
## Kiểm tra kết nốiSau khi nạp tiền, hãy xác nhận lại bằng một lệnh cURL nhanh. Việc này giúp bỏ qua mã nguồn ứng dụng để xác nhận API key đã hoạt động trở lại.

curl https://api.deepseek.com/chat/completions
-H "Content-Type: application/json"
-H "Authorization: Bearer $DEEPSEEK_API_KEY"
-d '{ "model": "deepseek-chat", "messages": [{"role": "user", "content": "test"}] }'


Một yêu cầu thành công sẽ trả về đối tượng JSON chứa phản hồi văn bản. Nếu bạn vẫn thấy lỗi 402, hãy đợi khoảng 5 phút để hệ thống thanh toán cập nhật bộ nhớ đệm của API gateway.

Related Error Notes