Saltar al contenido principal
La API usa los mismos créditos que la app: cada clasificación descuenta del saldo de tu organización. No hay un cobro aparte por la API.

Cómo se descuenta

  1. Al crear la clasificación se aparta 1 crédito del saldo.
  2. Si llega a resolved, ese crédito se descuenta.
  3. Si falla o queda abandoned, el crédito vuelve al saldo.
  4. Si pasa a pending_data, el crédito vuelve al saldo y se aparta de nuevo cuando respondés las preguntas. En total, la clasificación cuesta 1 crédito.
Con la misma Idempotency-Key, un reintento devuelve la misma clasificación y no aparta otro crédito.

Cuando no hay créditos

POST /classifications y POST /classifications/{id}/answers responden 402 con el tipo insufficient-credits. No se crea nada y la clave de idempotencia queda libre: después de cargar créditos podés reintentar con la misma.
purchase_url es la página donde un owner o un admin compra créditos adicionales. Cada crédito adicional cuesta el precio por crédito de tu plan: los valores están en la sección de precios. Los créditos adicionales no vencen.

Ver el saldo y el consumo

  • Saldo: GET /balance devuelve los créditos disponibles, los mismos que ves en la app.
  • Consumo de la API: GET /usage devuelve las clasificaciones por API resueltas en el mes en curso y los créditos que descontaron.
  • En la app: Ajustes → API → Consumo del mes, con las clasificaciones, los créditos, las llamadas, los errores y el desglose por key.
El mes es calendario, en hora de Buenos Aires.
El playground de esta documentación usa tu key real: una clasificación creada desde acá descuenta un crédito igual que cualquier otra.