Cuenta
Dos endpoints de solo lectura para la cuenta propietaria de la clave API: una instantánea del plan y los créditos disponibles (con los dos números que un SDK necesita para autolimitarse) y un libro de contabilidad paginado del consumo de créditos para la conciliación de autoservicio.
Obtener cuenta
Devuelve el plan y los créditos efectivos de su cuenta — si su cuenta es miembro de un equipo, esto ya refleja el plan/fondo de créditos del propietario del equipo, no su propio plan de membresía individual.
Parámetros
Ninguno — la cuenta se determina completamente por la clave API en el encabezado Authorization.
max_batch_size y upload_concurrency se proporcionan para que un SDK cliente pueda autolimitar su propio bucle de subida en lugar de descubrir estos límites al toparse primero con errores invalid_parameter/ rate_limit_exceeded.
Posibles errores
missing_api_key/invalid_api_key/plan_required— consulte Manejo de errores.
Obtener uso de la cuenta
Un registro paginado, del más reciente al más antiguo, de cada evento que afecta créditos en su cuenta: deducciones de extracción, deducciones de anotación de bbox y reembolsos. Diseñado para conciliar "cuántos créditos me costó esto", no para impulsar una interfaz (compare las cadenas de visualización preformateadas de /profile/usage_history, que este endpoint no devuelve — usted obtiene valores estructurados de amount con signo).
Parámetros
| Nombre | Ubicación | Tipo | Descripción |
|---|---|---|---|
limit | consulta, opcional | entero | 1–200. Predeterminado 50. |
batch_name | consulta, opcional | cadena | Restrinja el registro a entradas de un solo lote — "cuántos créditos me costó el lote X". |
page_token | consulta, opcional | cadena | Cursor opaco de la respuesta anterior next_page_token. Este endpoint pagina del más reciente al más antiguo (a diferencia de otros endpoints de listado v1, que pagan del más antiguo al más reciente) — el token sigue siendo opaco y hace el mismo recorrido, solo difiere el orden subyacente. Consulte Paginación. |
amount tiene signo: negativo para gastos (deducciones de extracción/bbox), positivo para créditos devueltos (reembolsos/reembolsos por cancelación) — así, sumar los valores de amount de una página le da el cambio neto en esa página. document_id es el mismo espacio de ID que el document_id de Documentos (el registro interno lo llama task_id; este endpoint lo renombra por coherencia con el resto de v1).
La magnitud de una deducción no siempre es 1. Cada cuenta tiene un nivel de modelo — Estándar (el predeterminado), Avanzado o Premium — que determina qué modelo de IA ejecuta sus extracciones y cuántos créditos cuesta cada documento procesado: 1 para Estándar, 3 para Avanzado, 6 para Premium. No hay forma de configurar esto por llamada a la API; lo asigna a la cuenta el equipo de ImageToTable.ai. Cuando una cuenta no está en Estándar, el campo action lleva un sufijo de nivel en lugar del nombre simple — deduction_advanced, deduction_premium — para que pueda detectar un cargo no estándar sin inspeccionar amount directamente. Los reembolsos no se ven afectados por cambios posteriores de nivel: una tarea siempre se reembolsa al nivel que se cobró realmente cuando comenzó el procesamiento, no al nivel que la cuenta tenga cuando se ejecuta el reembolso, por lo que la magnitud de una fila de refund siempre coincidirá con la fila de deduction/deduction_<tier> que está revirtiendo. Consulte Configuración de la cuenta y comportamiento de la API para ver cómo esto interactúa con todas las demás configuraciones a nivel de cuenta que v1 lee.
Posibles errores
missing_api_key/invalid_api_key/plan_required— consulte Manejo de errores.invalid_parameter—limitopage_tokenno válidos.