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.

Ejemplos de costo en créditos
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.

Encabezados según el plan

Unidades de los encabezados por tipo de plan
Plan	Encabezados de éxito	Unidad
Créditos prepago	`X-RateLimit-Limit` `X-RateLimit-Remaining`	Créditos; límite = saldo antes de la solicitud y remaining = saldo posterior
Cuota mensual contratada	`X-RateLimit-Limit` `X-RateLimit-Remaining` `X-RateLimit-Reset`	Problemas; reset se expresa en segundos hasta el siguiente mes UTC
Medido, solo negociado	`X-Usage-Accrued-Cents` `X-Usage-Cap-Cents` `X-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.