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.
¿Cómo funciona?
La facturación prepagada permite a los usuarios de la API comprar uso por adelantado. Los créditos que compraste se aplicarán a tu factura mensual. Esto significa que cualquier uso de la API se descontará primero de los créditos prepagados. Si tu uso excede los créditos que compraste, se te cobrará por el monto adicional.
La facturación prepagada ayuda a los desarrolladores a entender a qué se comprometen desde el principio, lo que puede ofrecer más previsibilidad para la planificación del presupuesto y la gestión del gasto.
Resolve payment and credit issues
Configurar la facturación prepagada
Aquí te mostramos cómo los usuarios con facturación mensual o los nuevos usuarios de API pueden configurar la facturación prepagada:
En el flujo de configuración, configura la recarga automática antes de confirmar tu compra inicial de crédito.
La recarga automática se activa de forma predeterminada durante la configuración. Si no quieres recargas automáticas, desactívalas antes de continuar.
Si mantienes activada la recarga automática, establece el monto de recarga, el umbral y el límite mensual de recarga opcional. Las compras manuales de créditos no cuentan para el límite de recargas. Si una recarga automática superara este límite mensual, solo se podrá agregar el monto restante; si el límite ya se alcanzó, la recarga automática no agregará más créditos hasta el próximo mes.
Ten en cuenta que cualquier crédito comprado caducará después de 1 año y no es reembolsable.
Después de comprar créditos, deberías poder empezar a usar la API. Ten en cuenta que puede haber un par de minutos de demora mientras nuestros sistemas se actualizan para reflejar tu saldo de crédito.
Compra de créditos adicionales
Una vez que hayas consumido todos tus créditos, tus solicitudes de API comenzarán a enviarte un error que te informará que has alcanzado tu cuota de facturación. Si quieres continuar usando tu API, puedes regresar al portal de facturación y usar el botón “Agregar al saldo” para comprar créditos adicionales.
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.