OneMux/Tài liệu/Câu hỏi thường gặp

Câu hỏi thường gặp

Gặp lỗi khi gọi API? Nhanh chóng xác định vấn đề theo mã trạng thái. Trang này liệt kê các mã lỗi thường gặp nhất và cách khắc phục; phần lớn vấn đề có thể tự giải quyết trong vòng 1 phút.

Khắc phục nhanh

Khi mã gặp lỗi, trước tiên hãy tìm mã trạng thái HTTP (chẳng hạn 401, 429), rồi đối chiếu cách xử lý:

Mã trạng tháiNguyên nhânCách khắc phục
401API Key không hợp lệKiểm tra định dạng (sk-xxx) và tính hợp lệ của khóa
402Không đủ số dưNạp tiền trong bảng điều khiển
404Model ID không chính xácSao chép ID chính xác từ trang mô hình
429Gửi yêu cầu quá nhanhGiảm tần suất, thử lại sau 10 giây
500Sự cố từ dịch vụ thượng nguồnThử lại sau hoặc chuyển sang mô hình khác

401 - API Key không hợp lệ

Nguyên nhân thường gặp nhất:

  • Có khoảng trắng thừa khi sao chép
  • Sai định dạng (không bắt đầu bằng sk-)
  • Khóa đã bị xóa

Cách khắc phục nhanh:

# ✅ Định dạng đúng
api_key = "sk-1234567890abcdef"

# ❌ Lỗi thường gặp
api_key = " sk-1234567890abcdef "  # Có khoảng trắng ở đầu và cuối
api_key = "1234567890abcdef"       # Thiếu tiền tố sk-

Truy cập bảng điều khiển để sao chép lại hoặc tạo khóa mới.

402 - Không đủ số dư

Số dư tài khoản không đủ để thanh toán yêu cầu này.

Truy cập trung tâm thanh toán để nạp tiền.

Lưu ý: Yêu cầu có ngữ cảnh dài (chẳng hạn Gemini xử lý 100 万 tokens) sẽ tạm giữ khoản phí tối đa có thể phát sinh. Hãy đảm bảo số dư đủ.

404 - Không tìm thấy mô hình

Nguyên nhân thường gặp:

  • Model ID bị viết sai
  • Sử dụng tên mô hình cũ (chẳng hạn gpt-4o đã được thay thế bằng gpt-6.1-sol)
  • Sai đường dẫn Base URL

Cách khắc phục:

Lấy Model ID chính xác

  1. 1

    Truy cập trang mô hình

    Mở https://onemux.net/models

  2. 2

    Tìm mô hình cần dùng

    Tìm kiếm hoặc duyệt để tìm mô hình mong muốn

  3. 3

    Sao chép Model ID

    Nhấp vào nút sao chép hoặc sao chép thủ công toàn bộ ID

Xác nhận Base URL là https://api.onemux.net/v1 (lưu ý có /v1 ở cuối)

429 - Gửi yêu cầu quá nhanh

Gửi quá nhiều yêu cầu trong thời gian ngắn, khiến giới hạn tần suất được kích hoạt.

Cách khắc phục:

  • Giảm tần suất gửi yêu cầu
  • Chờ 10-30 giây rồi thử lại
  • Thêm logic tự động thử lại (xem tài liệu xử lý lỗi)
  • Giảm số lượng tác vụ chạy đồng thời

500/502/503 - Sự cố dịch vụ

Dịch vụ mô hình thượng nguồn tạm thời không khả dụng.

Cách khắc phục:

  • Chờ 10-30 giây rồi thử lại
  • Chuyển sang mô hình khác
  • Kiểm tra trang trạng thái để biết tình trạng dịch vụ

Trình tự khắc phục khi chưa xác định được vấn đề

Khắc phục từng bước

  1. 1

    Kiểm tra số dư

    Đăng nhập vào bảng điều khiển để xác nhận số dư còn đủ

  2. 2

    Kiểm tra API Key

    Sao chép lại toàn bộ khóa, đảm bảo không có khoảng trắng

  3. 3

    Kiểm tra Model ID

    Sao chép lại từ trang mô hình

  4. 4

    Kiểm tra Base URL

    Xác nhận là https://api.onemux.net/v1

  5. 5

    Khởi động lại phần mềm

    Lưu cấu hình rồi khởi động lại ứng dụng