Créditos, cuotas y límites
Calcula el costo de una solicitud e interpreta los encabezados de uso correspondientes a tu plan.
- Dirigido a
- Desarrolladores y administradores de socios
- Antes de empezar
- Una clave de API y saber si la cuenta es prepago o tiene contrato
Cómo se calcula el consumo
Cada generación completada consume un crédito por ejercicio generado (respuesta incluida). Se suma count de todas las entradas.
| Problemas solicitados | Créditos |
|---|---|
| 5 | 5 |
| 20 | 20 |
| 50 | 50 |
- GET /catalog es gratuito, aunque requiere una clave válida.
- JSON, PDF, LaTeX y la creación de una inserción tienen el mismo cálculo.
- Las visualizaciones de una inserción son gratuitas.
- Una solicitud que falla durante la validación, generación, renderizado o creación no consume créditos ni cuota.
Créditos gratuitos para pruebas
Las cuentas personales (no las de organización) reciben 50 créditos gratuitos la primera vez que crean una clave de API, para poder probar solicitudes reales antes de comprar. Este saldo es independiente del saldo unificado habitual: se gasta primero en las solicitudes autenticadas con esa clave y, al agotarse, las solicitudes siguen funcionando usando el saldo normal de la cuenta sin un error distinto. Se renueva a 50 aproximadamente doce meses después de otorgarse.
Encabezados según el plan
| Plan | Encabezados de éxito | Unidad |
|---|---|---|
| Créditos prepago | X-RateLimit-LimitX-RateLimit-Remaining | Créditos; límite = saldo antes de la solicitud y remaining = saldo posterior |
| Cuota mensual contratada | X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset | Problemas; reset se expresa en segundos hasta el siguiente mes UTC |
| Medido, solo negociado | X-Usage-Accrued-CentsX-Usage-Cap-CentsX-Usage-Warning | Centavos acumulados y tope opcional |
Límites de solicitud
- Cada entrada debe solicitar un entero entre 1 y 30 problemas.
- La suma de todas las entradas no puede superar 150 problemas.
- difficulty debe ser easy, medium o hard y estar disponible para el tema elegido.
- Una inserción admite como máximo 20 dominios permitidos y un título de hasta 128 caracteres.
- Existe un limitador de ráfagas por clave. Si se activa, la respuesta 429 incluye Retry-After; no asumas una tasa global fija entre despliegues.
Cuando no queda capacidad
Una cuenta prepago recibe 402 insufficient_credits hasta comprar o recibir créditos. Una cuota mensual agotada recibe 429 quota_exceeded y Retry-After hasta el siguiente mes UTC. No repitas estas solicitudes automáticamente.