Xử lý lỗi thanh toán và giới hạn chi tiêu của khách hàng

Sử dụng Đăng nhập với ShareAI để xác thực và ủy quyền rõ ràng Thanh toán với ShareAI cho các hành động được tài trợ bởi tài khoản. openid Phạm vi một mình không bao giờ cho phép chi tiêu. Suy luận AI yêu cầu inference hoặc một surcharge cấp phép đã được phê duyệt và đồng ý; payments các yêu cầu thanh toán được xác nhận riêng biệt. Khách hàng kiểm soát giới hạn AI hàng tháng trong Console. Ứng dụng của bạn không thể thay đổi nó.

Xử lý lỗi theo mã#

HTTP 402 · insufficient_credits: tài khoản thanh toán không có đủ tín dụng chưa hết hạn đủ điều kiện cho nhà cung cấp/mô hình và yêu cầu này. Yêu cầu khách hàng quản lý tín dụng của họ. Một số tín dụng có giới hạn nhà cung cấp hoặc mô hình.

HTTP 402 · application_spending_limit_exceeded: giới hạn hàng tháng đã đạt, các yêu cầu được đặt trước sử dụng mức cho phép có sẵn, hoặc phí của yêu cầu này sẽ vượt quá giới hạn đó. Không xử lý điều này như một giới hạn tốc độ hoặc tự động thử lại. Yêu cầu khách hàng thay đổi giới hạn hoặc chờ đến khi reset_at.

HTTP 429 · oauth_rate_limit: giới hạn tạm thời về yêu cầu/đồng thời. Thực hiện theo Retry-After và backoff có giới hạn. HTTP 401 · consent_required: sự đồng ý đã hết hạn, bị thu hồi hoặc không còn hợp lệ; lấy ủy quyền mới thay vì yêu cầu nạp thêm.

{
  "error": {
    "type": "billing_error",
    "code": "application_spending_limit_exceeded",
    "message": "This application's monthly AI spending limit has been reached or this request would exceed it. Manage the limit or wait for the next month.",
    "management_url": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "help": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "monthly_limit": "50",
    "reset_at": "2026-10-01T00:00:00Z"
  }
}

Hai lỗi tài chính sử dụng error.type = billing_error. management_url là điểm đến khôi phục của khách hàng; help là bí danh tương thích của nó. monthly_limit là chuỗi số thập phân EUR chính xác và reset_at là UTC. Chúng xuất hiện trên các lỗi giới hạn, và có thể không xuất hiện trên các lỗi tín dụng không đủ.

Mở tài khoản thanh toán chính xác#

Cung cấp một hành động Quản lý thanh toán hiển thị bằng cách sử dụng URL được trả về. Ngữ cảnh mờ hết hạn sau 15 phút, xác định tài khoản thanh toán và kết nối ban đầu, và tồn tại qua chuyển hướng đăng nhập. Console kiểm tra quyền chủ sở hữu/quản trị viên của khách truy cập đã đăng nhập trước khi chọn tài khoản đó. Không thay thế nó bằng trang thanh toán của chủ sở hữu ứng dụng, tạo ID vai trò, thêm mã truy cập, hoặc tự động chuyển hướng khách hàng.

Sử dụng danh sách cho phép cho nguồn gốc Console và rel="noopener noreferrer" nếu mở một tab mới. Liên kết là điều hướng, không phải ủy quyền hoặc bằng chứng rằng quỹ đã được thêm vào. Không lưu trữ nó như một dấu trang vĩnh viễn hoặc trong nhật ký công khai. Khi hết hạn, khách hàng có thể mở Billing trực tiếp. Một yêu cầu mới có thể trả về một liên kết mới sau khi khách hàng yêu cầu thử lại rõ ràng.

const response = await fetch("https://api.shareai.now/api/v1/chat/completions", options);
const body = await response.json();
const error = body.error;
if (response.status === 402 && error?.type === "billing_error") {
  const message = error.code === "application_spending_limit_exceeded"
    ? "Your monthly limit for this app has been reached."
    : "Your ShareAI account needs eligible credits.";
  showBillingMessage(message);
  if (error.management_url) {
    const target = new URL(error.management_url);
    if (target.origin === "https://console.shareai.now") {
      // Render a user-activated link; never silently open it or retry spending.
      showManageBillingLink(target.href);
    }
  }
  return;
}
if (!response.ok || error) throw new Error(error?.message || "Request failed");
renderAnswer(body);

Phát trực tuyến và quyết toán cuối cùng#

ShareAI kiểm tra giới hạn trước khi chấp nhận/kết nối và kiểm tra chi phí mạng thực tế cộng phụ phí một cách nguyên tử tại thời điểm quyết toán. Các yêu cầu đồng thời chia sẻ cùng một giới hạn. Ước tính đầu vào dành chỗ trống; độ dài đầu ra không được biết trước. Một khoản phí cuối cùng vượt quá mức cho phép còn lại sẽ bị từ chối mà không có khoản ghi nợ sử dụng hoặc tín dụng phụ phí của Builder.

Đối với Chat Completions SSE, xử lý event: error với cùng error.code các trường khôi phục. Đối với Responses SSE, xử lý response.failed và đọc response.error. Khi luồng bắt đầu, trạng thái HTTP của nó đã là 200; nội dung một phần không có nghĩa là hoàn thành thành công. Không đánh dấu kết quả là hoàn thành, thực hiện các hành động trả phí tiếp theo hoặc tự động gửi lại sau một lỗi cuối cùng. Chat không phát trực tuyến, Responses, Embeddings và Images hiển thị lỗi thanh toán dưới dạng HTTP 402 root error phong bì.

Phạm vi và đặt lại#

Tháng dương lịch được tính theo UTC. Giới hạn được áp dụng cho mỗi tài khoản thanh toán và ứng dụng, chia sẻ giữa các khách hàng OAuth, quyền cấp và token được làm mới; một dịch vụ khách hàng sử dụng ID công việc ổn định của nó qua các lần xoay khóa Sản xuất. Chỉ chi phí mạng AI đã được thanh toán cộng với phụ phí mới được tính. Các gói đăng ký cố định và các giao dịch mua được xác nhận riêng có sự ủy quyền thanh toán riêng và không tiêu thụ giới hạn AI này. Giá trị bằng 0 sẽ tạm dừng chi tiêu AI bổ sung; null có nghĩa là không có giới hạn. Các khoản phí trước đây được giữ lại khi giới hạn được chỉnh sửa hoặc kết nối được ủy quyền lại.

Đây là các công cụ kiểm soát của khách hàng trong Console, không phải là điểm cuối dành cho nhà phát triển để tăng ngân sách. Tiếp tục thực thi phạm vi của quyền cấp, các mô hình đã được phê duyệt, các tùy chọn nhà cung cấp của khách hàng và các điều khoản phụ phí đã được chấp nhận. Hướng dẫn thanh toán cho khách hàng · API Thanh toán.