Configuración de la cuenta y comportamiento de la API
Parte del comportamiento de su cuenta se configura una sola vez — la mayoría en la página de configuración del perfil de la aplicación web, y una excepción (nivel de modelo, más abajo) solo por el equipo de ImageToTable.ai — en lugar de a través de esta API. Esta página explica, para cada uno de estos ajustes, exactamente cómo se manifiesta en v1: si la API lo sigue incondicionalmente o le permite anularlo por solicitud. Esto no se distribuye deliberadamente entre los documentos de cada endpoint — se recopila aquí porque el comportamiento transversal es fácil de pasar por alto si solo se lee la página de referencia de un endpoint a la vez.
La regla general
v1 lee la configuración actual de su cuenta directamente y la aplica — no existe un sistema de configuración separado a nivel de API y (con una excepción deliberada, más abajo) no hay forma de anular un ajuste de la cuenta para una sola solicitud. Esto es intencional: mantener dos lugares independientes para configurar el mismo comportamiento (la aplicación web y una configuración de API paralela) inevitablemente terminaría desincronizándose, y el objetivo es que la misma cuenta se comporte de la misma manera sin importar qué superficie — aplicación web, esta API o el complemento de Google Sheets — haya iniciado el procesamiento.
Configuración y su comportamiento en la API
| Configuración | Comportamiento en la web | Comportamiento en la API v1 | ¿Se puede anular por solicitud? |
|---|---|---|---|
anotación automática de bboxauto_annotate_bbox | Un interruptor a nivel de cuenta. Cuando está activado, cada extracción completada activa automáticamente una pasada de anotación de bbox de pago. | Se sigue exactamente: los lotes creados y procesados a través de v1 obedecen este interruptor sin excepción. Si está activado, se le puede facturar la anotación de bbox incluso si nunca llama a POST /documents/{document_id}/bbox usted mismo. | No. No hay forma a nivel de solicitud de omitirlo o forzarlo. |
Calidad de procesamientothinking_type | Una configuración a nivel de cuenta que elige un nivel de velocidad/calidad para el procesamiento. | La única excepción a la regla anterior. Cuando omite quality en POST /batches/{batch_name}/process, se recurre a la configuración actual de su cuenta — mismo comportamiento que la aplicación web. Pero también puede pasar quality: "fast" o quality: "high" en esa solicitud para anularlo solo para esa llamada. | Sí — la única configuración en esta página que puede anular por solicitud. |
Retención de datosauto_delete / auto_delete_after | Una configuración a nivel de cuenta para eliminar automáticamente las imágenes originales N días después del procesamiento. | Se sigue exactamente: los documentos creados a través de v1 están sujetos a la misma política de retención que cualquier cosa subida a través de la aplicación web. | No. |
| Modo de procesamiento ( rec_mode interno, expuesto como mode) | La aplicación web actualmente admite extracción en formato tabla y conversión completa del documento a Word. | v1 actualmente admite solo mode=table (extracción de campos estructurados). La conversión completa del documento está planificada pero aún no disponible a través de la API. | No aplicable todavía — solo hay un valor para elegir. Cuando se lancen más modos, esto será una adición pura, no un cambio de comportamiento en el valor existente. |
Nivel de modelomodel_tier | Qué modelo de IA ejecuta las extracciones de una cuenta y cuánto cuesta cada documento procesado: Standard (1 crédito, el valor predeterminado para todas las cuentas), Advanced (3 créditos) o Premium (6 créditos). Lo asigna el equipo de ImageToTable.ai; no hay un selector de nivel en la configuración de la cuenta. | Se sigue exactamente. POST /batches/{batch_name}/process deduce créditos según la tarifa que cueste el nivel actual de la cuenta, sin forma de solicitar un nivel diferente para una sola llamada. El nivel queda fijado en el momento en que se llama a ese endpoint: un documento ya en cola conserva el nivel (y el costo en créditos) con el que se le cobró, incluso si el nivel de la cuenta cambia antes de que ese documento termine de procesarse, y se reembolsa con ese mismo nivel fijado si luego se cancela o falla. Consulte Uso de la cuenta para ver cómo aparece un cargo que no sea Standard en el registro de créditos. | No. Más estricto que cualquier otra fila de esta página: ni siquiera es una configuración de cuenta de autoservicio en la aplicación web, así que no hay nada que leer y replicar por solicitud: v1 no tiene un parámetro de nivel en ninguna parte. |
¿Por qué no añadir simplemente anulaciones a nivel de solicitud?
La anotación automática de bbox y la política de retención se tratan como gobernanza a nivel de cuenta, no como preferencias por llamada: son el tipo de interruptor de «activado para todo o desactivado para todo» en el que permitir que una sola llamada a la API se desvíe silenciosamente de la configuración vigente de la cuenta crearía exactamente el problema de deriva entre dos fuentes de configuración que este diseño evita. quality es diferente: qué nivel de velocidad/calidad tiene sentido puede variar legítimamente de una llamada a otra (este lote necesita salir rápido, aquel necesita la máxima precisión), por lo que se trata como una decisión operativa en lugar de un ajuste de gobernanza, y se habilita como la única anulación.
El nivel de modelo va un paso más allá de «sin anulación por solicitud»: ni siquiera es un ajuste de cuenta de autoservicio. Las demás filas de esta página son cosas que usted configura en la página de ajustes del perfil y que v1 simplemente replica; el nivel de modelo es una tarifa que el equipo de ImageToTable.ai asigna según la carga de trabajo que una cuenta está ejecutando realmente, ya que cambia directamente lo que cuesta cada documento. Exponerlo como algo que un llamador pudiera cambiar por solicitud (o incluso por cuenta, sin asistencia) permitiría que un único valor erróneo multiplicara silenciosamente la factura de un lote por 3 o por 6 sin ningún paso de confirmación en el medio: la versión de «los créditos son dinero real» del mismo problema de deriva que el resto de esta página evita.