PieBox
Documentation

Quota & Limits

Monthly quota, top-up requests, and common error codes

Monthly Quota

  • Each user has a monthly base quota that resets automatically on the 1st of each month
  • When the quota is exhausted, the API will return 402 budget_exceeded
  • You can check your current usage via the "View My Quota" feature in the AI Hub

Requesting a Top-Up

When you need more quota, submit a request through the "Request Top-Up" feature in the AI Hub. It takes effect immediately after approval.

Common Error Codes

StatusError TypeDescription
401unauthorizedInvalid or missing API Key
402budget_exceededMonthly quota exhausted — request a top-up via AI Hub
403app_disabledApplication has been disabled — contact your admin
429rate_limitedRequest rate exceeded — please retry later

Important Notes

  1. Keep your API Key safe — do not commit it to code repositories or share it publicly
  2. If you encounter issues, submit feedback through the "Report Issue" feature in the AI Hub