Uso de IA, retención y eliminación
Lee la actividad privada de procesamiento de IA y recuentos de tokens, comprende la expiración y elimina resultados completados de forma segura.
Informes de actividad privada#
Usa GET /v1/ai/jobs/usage?days=30 con tu clave de proyecto API existente o una sesión de navegador iniciada. Días permitidos: 1–90. Los informes se aíslan tanto por cuenta de HQTools como por proyecto API, devolviendo conteos por operación y estado, más tokens de entrada/salida registrados. Los trabajos eliminados se excluyen; los trabajos completados expirados pueden contarse sin retener su contenido de documento.
curl 'https://api.pdfhq.io/v1/ai/jobs/usage?days=30' \
-H 'x-api-key: PROJECT_API_KEY'Estas cifras son observabilidad de procesamiento, no tu factura, asignación de cuota o saldo de cartera. HQTools sigue siendo la autoridad para cargos de créditos y pagos. No se devuelve PDF original, prompt o respuesta modelo en el endpoint de uso.
Caducidad y eliminación de contenido de IA#
Las respuestas de estado del trabajo incluyen content_expires_at y content_purged_at. Las respuestas de IA expiradas ya no son accesibles, incluso si la eliminación automática aún no se ha ejecutado. Los trabajos completados también se pueden eliminar manualmente a través de DELETE /v1/ai/jobs/{job_id}. Las exportaciones CSV de facturas devuelven HTTP 410 después de la expiración.
La retención predeterminada de solicitudes de IA y resultados generados es de siete días y se puede configurar de 1 a 30 días. Esto cubre solicitudes y resultados de IA, no PDF originales cargados, copias de seguridad de plataforma, registros o retención de proveedores externos. Contacta con soporte sobre el ciclo de vida del documento y subprocesadores para cargas reguladas.
Cargos del proveedor inciertos#
Un trabajo marcado como needs_reconciliation no se reintenta automáticamente: puede ocurrir un tiempo de espera del proveedor después de una inferencia facturable. El soporte verifica los registros del proveedor y HQTools, luego aprueba un reembolso/liberación auditado cuando corresponda. Nunca envíe una nueva solicitud solo para recuperar una operación existente que ha agotado el tiempo de espera.
