Overview
Prepaid billing lets you purchase credits before using the API. Your credit balance decreases as you use the API. If your account has free credits, those are used before purchased credits.
New API accounts use prepaid billing. If you already use monthly billing, you can also purchase credits in advance. Those credits offset your monthly invoice.
Purchased credits expire after 1 year and are non-refundable. OpenAI cannot extend the expiration date of purchased credits or credit grants.
Set up prepaid billing
Before you begin, make sure you have permission to manage billing for the API organization you want to fund.
Go to that organization’s API billing overview.
Select Add payment details and complete the payment-information step.
Choose your initial credit purchase amount. The minimum purchase is $5, and the default amount is $10.
Review Use auto-reload before confirming your purchase. It is turned on by default during setup. Turn it off if you do not want automatic credit purchases.
If you keep Use auto-reload on, set the balance threshold, the balance you want to restore to, and an optional monthly reload limit.
Confirm your credit purchase.
Your trust tier, which is based on your usage and payment history, determines the maximum credit balance your account can hold.
After a successful purchase, it may take a few minutes for your balance to update.
Manage automatic recharges
Auto recharge adds credits when your balance falls below the threshold you set. The minimum recharge amount is $5. Your trust tier determines the maximum recharge amount.
The optional monthly recharge limit controls how much can be purchased through automatic recharges:
Manual credit purchases do not count toward this limit.
If an automatic recharge would exceed the remaining monthly limit, only the remaining amount may be added, provided it meets the minimum purchase requirement.
If the monthly limit has already been reached, automatic recharges will not add more credits until the next month.
A recharge limit is not an API usage limit. It controls automatic credit purchases, not the amount of existing credits you can use.
Add credits when your balance runs out
When a prepaid account runs out of credits, API requests begin returning a billing error. An error with the code credit_balance_exhausted means the organization has no prepaid credits remaining.
To purchase more credits:
Go to your API billing overview.
Select Buy credits or Add to credit balance, whichever appears.
Complete the credit purchase.
Allow a few minutes for the updated balance to appear before trying again.
كيف تعمل هذه الميزة
إن الفوترة مسبقة الدفع هي التي تتيح لمستخدمي واجهة API الاستخدام قبل الشراء. ويتم تطبيق الأرصدة التي اشتريتها على فاتورتك الشهرية. ويعني هذا أن أي استخدام لواجهة API سيتم خصمه أولًا من الرصيد المدفوع مسبقًا. وإذا تجاوز استخدامك الأرصدة التي اشتريتها، فسيتم عندئذٍ تحصيل رسوم مقابل مقدار الاستخدام الإضافي.
تساعد الفوترة مسبقة الدفع المطورين على معرفة التزاماتهم، مما يمنحهم دقةً في توقع التكاليف اللازمة لإعداد الميزانيات والتحكم في المصروفات.
Resolve payment and credit issues
إعداد الفوترة مسبقة الدفع
إليك كيفية إعداد الفوترة المسبقة الدفع لمستخدمي الفوترة الشهرية أو المستخدمين الجدد لواجهة API:
في مسار الإعداد، اضبط إعادة الشحن التلقائي قبل تأكيد شراء الرصيد الأولي.
تفعيل تشغيل إعادة الشحن التلقائي افتراضيًا أثناء الإعداد. إذا لم ترغب في عمليات الشحن التلقائي، عطلها قبل المتابعة.
إذا تركت ميزة إعادة الشحن التلقائي مفعّلة، فحدد مبلغ وعتبة إعادة الشحن والحد الشهري الاختياري. لا تُحتسب عمليات شراء الرصيد اليدوية ضمن حد إعادة الشحن. إذا تجاوزت إعادة الشحن التلقائي الحد الشهري، فلا يُضاف سوى المبلغ المتبقي؛ وإذا تم بلوغ الحد بالفعل، فلن تضيف ميزة إعادة الشحن التلقائي المزيد من الرصيد حتى الشهر التالي.
يرجى ملاحظة أن أي أرصدة تم شراؤها ستنتهي صلاحيتها بعد عام واحد ولا يمكن استرداد المبلغ المدفوعة مقابلها.
بعد شراء الأرصدة، ينبغي أن تتمكن من البدء في استخدام واجهة API. يرجى ملاحظة أنه قد يحدث تأخير لبضع دقائق بينما تقوم أنظمتنا بالتحديث لتعكس رصيدك.
شراء أرصدة إضافية
بمجرد استهلاك جميع أرصدتك، ستبدأ طلبات واجهة API الخاصة بك في إرجاع خطأ لإعلامك بوصولك إلى حد الفوترة المحدد. وإذا كنت ترغب في متابعة استخدام واجهة API، يمكنك العودة إلى بوابة الفوترة واستخدام زر "إضافة إلى الرصيد" لشراء أرصدة إضافية.
Payment is disputed or refunded
If a payment is disputed or refunded, credits equivalent to that amount are removed from your account.
Check other API limits
A positive credit balance does not mean a request is below every API limit. Request and token rate limits, your organization’s approved monthly usage limit, and any enforced spend limits are separate from your prepaid balance.
For rate-limit errors, see: Troubleshooting API rate limits and 429 errors.
For other billing-related errors, check the API error-code guide before purchasing additional credits.