Aiberm logo
Đăng nhập

Xử lý lỗi

Khi một yêu cầu API Aiberm thất bại, API trả về một đối tượng lỗi JSON. Dùng mã trạng thái HTTP, error.code và error.message để xác định vấn đề và quyết định bước tiếp theo.

Nếu bạn cần hỗ trợ, hãy kèm phản hồi lỗi đầy đủ với mọi request id.

Định dạng phản hồi lỗi

{
  "error": {
    "message": "用户额度不足, 剩余额度: ¥0.00 (request id: 20260622xxxxxxxx)",
    "type": "new_api_error",
    "code": "insufficient_user_quota"
  }
}
TrườngÝ nghĩa
messageThông báo lỗi dễ đọc. Phần cuối (request id: ...) là ID truy vết của yêu cầu này. Hãy kèm theo khi liên hệ hỗ trợ.
codeĐịnh danh nhóm lỗi. Đối chiếu với các lỗi thường gặp bên dưới.
typeDấu hiệu nguồn lỗi. Trong hầu hết trường hợp, bạn không cần xử lý trực tiếp.

Nếu message chứa nhiều giá trị (request id: ...), điều đó là bình thường. Nghĩa là yêu cầu đã đi qua nhiều lớp dịch vụ. Sao chép toàn bộ thông báo lỗi khi liên hệ hỗ trợ.

Mã trạng thái HTTP

Trạng tháiÝ nghĩaViệc cần làm
400Định dạng yêu cầu không hợp lệKiểm tra JSON yêu cầu, các trường bắt buộc, Content-Type và tên mô hình.
401API key không hợp lệKiểm tra API key có đúng, hết hạn, bị tắt, hoặc hết hạn mức không.
403Không có quyền hoặc số dư không đủKiểm tra số dư tài khoản, quyền token, quyền mô hình và IP nguồn.
404Không tìm thấy tài nguyênKiểm tra URL endpoint và chính tả tên mô hình.
429Quá nhiều yêu cầuGiảm đồng thời hoặc tần suất yêu cầu, rồi thử lại sau.
500Lỗi máy chủ nội bộThử lại sau. Nếu vẫn xảy ra, liên hệ hỗ trợ kèm request id.
503Tạm thời không có dịch vụMô hình hiện không có tuyến khả dụng. Thử lại sau hoặc liên hệ hỗ trợ.

Lỗi API Key và xác thực

Các lỗi này thường trả về 401.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
无效的令牌API key sai hoặc không tồn tại.Kiểm tra khóa đầy đủ, không thừa hoặc thiếu ký tự. Sao chép lại từ console.
该令牌已过期Token đã hết hạn.Tạo lại token trong console, hoặc gia hạn thời gian hiệu lực.
该令牌额度已用尽Hạn mức gán cho token này đã dùng hết.Tăng hạn mức token, hoặc dùng token khác còn đủ hạn mức.
该令牌状态不可用Token đã bị tắt.Bật token trong console, hoặc tạo token mới.
未提供令牌Yêu cầu không kèm API key.Thêm Authorization: Bearer sk-xxxxxx vào header yêu cầu.

Lỗi quyền và số dư

Các lỗi này thường trả về 403.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
用户额度不足, 剩余额度: ...Số dư tài khoản không đủ cho yêu cầu này.Nạp tiền tài khoản rồi thử lại.
预扣费额度失败, 用户剩余额度: ...Số dư không đủ để trang trải chi phí ước tính của yêu cầu.Nạp tiền, hoặc giảm max_tokens và rút ngắn đầu vào.
您的 IP 不在令牌允许访问的列表中Token có danh sách IP cho phép, và IP hiện tại không được phép.Dùng IP được phép, hoặc cập nhật danh sách cho phép trong console.
用户已被封禁Tài khoản đã bị đình chỉ.Liên hệ hỗ trợ để biết chi tiết.
无权访问 xxx 分组Token không có quyền truy cập nhóm được yêu cầu.Dùng nhóm được phép, hoặc xin quyền truy cập.
该令牌无权访问模型 xxxDanh sách mô hình được phép của token không gồm mô hình này.Dùng mô hình được phép, hoặc cập nhật quyền mô hình của token trong console.

Lỗi nội dung yêu cầu

Các lỗi này thường trả về 400.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
Invalid request, ...Không phân tích được phần thân yêu cầu.Kiểm tra JSON hợp lệ và Content-Type là application/json.
未指定模型名称，模型名称不能为空Yêu cầu thiếu trường model.Thêm model đúng vào phần thân yêu cầu.
Các thông báo như 检测到敏感词Đầu vào khớp quy tắc an toàn nội dung.Điều chỉnh đầu vào rồi thử lại.

Lỗi giới hạn tốc độ

Các lỗi này thường trả về 429.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
您已达到请求数限制：N分钟内最多请求M次Bạn đã đạt giới hạn số yêu cầu thành công.Giảm tần suất yêu cầu và thử lại sau khi cửa sổ giới hạn đặt lại.
您已达到总请求数限制：...，包括失败次数...Đã đạt giới hạn tổng số yêu cầu, gồm cả yêu cầu thất bại.Kiểm tra xem các yêu cầu thất bại có đang lặp vòng không, sửa nguyên nhân rồi thử lại.

Lỗi mô hình và tuyến

Các lỗi này thường trả về 404 hoặc 503.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
模型不存在Tên mô hình viết sai, hoặc mô hình này chưa được bật cho token.Xác nhận tên mô hình và quyền mô hình của token.
无可用渠道Mô hình hiện không có tuyến khả dụng.Thử lại sau. Nếu vẫn không khả dụng, liên hệ hỗ trợ.

Lỗi máy chủ

Các lỗi này thường trả về 500 hoặc 503.

Thông báo bạn có thể thấyNguyên nhân thường gặpCách xử lý
Thông báo lỗi nội bộSự cố máy chủ tạm thời, hoặc dịch vụ thượng nguồn tạm thời không khả dụng.Thử lại sau. Nếu vẫn xảy ra, liên hệ hỗ trợ kèm request id.

Trước khi liên hệ hỗ trợ

Để chúng tôi xác định vấn đề nhanh hơn, hãy cung cấp:

  1. Phản hồi lỗi đầy đủ, gồm message, code và mọi request id.
  2. Thời điểm gần đúng khi sự cố xảy ra.
  3. Tên mô hình và URL endpoint bạn đã gọi.
  4. Một vài ký tự đầu của API key, chẳng hạn sk-abcd.... Đừng gửi toàn bộ khóa.
Chỉnh sửa trang này trên GitHub