Créditos de API

La API de búsqueda es prepagada. Mantienes un saldo de créditos de API, en la moneda de tu cuenta, y cada solicitud facturable lo descuenta. Es el modelo al estilo Anthropic: pagas lo que usas, desde un saldo que recargas por adelantado. La búsqueda en el sitio está cubierta por tu membresía y nunca toca este saldo — los créditos son solo para la API.

Dos bolsas

Tu saldo es la suma de dos bolsas separadas:

Una solicitud gasta primero la bolsa incluida y luego la comprada, de modo que la asignación mensual siempre se usa antes que el crédito pagado. Un descuento nunca deja una bolsa por debajo de cero; una solicitud en curso siempre se completa y el saldo se detiene en cero.

La asignación mensual (Suede Ultimate)

Suede Ultimate incluye cada período crédito por valor de 1.000 solicitudes de API, depositado en la bolsa incluida. En USD son $20,00 (1.000 × $0,02 por solicitud); en cada región se concede el importe equivalente en su moneda. La asignación se concede al activarse la membresía y se vuelve a conceder al comienzo de cada período.

Suede Pro no incluye asignación mensual: los miembros Pro usan la API puramente de pago por uso, comprando créditos cuando los necesitan. Cambiar de plan surte efecto en tu próxima renovación: tu primer período Ultimate inicia la asignación y tu primer período Pro la termina (el crédito incluido restante caduca con su último período Ultimate, como siempre).

Qué cuesta una solicitud

Cada solicitud facturable cuesta un importe fijo en tu moneda:

Consultar tu saldo

• En el navegador — abre Ajustes → Facturación → Créditos de API (o directamente /account/credits). Muestra el total, cada bolsa, cuándo se restablece la bolsa incluida y una estimación de cuántas solicitudes cubre el saldo.
• Desde la API — llama a GET /v1/usage. Devuelve included_cents, purchased_cents, el total y un recuento estimado de solicitudes, y nunca consume crédito. El mismo saldo viaja en cada respuesta facturable en las cabeceras X-Credits-Balance y X-Credits-Requests-Remaining.

Cuando el saldo se agota

Al llegar a cero, los endpoints facturables devuelven 402 insufficient_credits. La solución es comprar más créditos o activar la recarga automática. Leer tu uso sigue funcionando a cero — GET /v1/usage nunca está limitado por crédito.