Documentación de Metagrapho

Compatible con RGPD, Austria

Preguntas frecuentes

Introducción

La API de Transkribus facilita el procesamiento de imágenes utilizando la tecnología Transkribus HTR (Reconocimiento de Texto Manuscrito). Con esta API, los usuarios pueden enviar imágenes para procesamiento y luego recuperar resultados usando el processId proporcionado.

Autenticación

Para interactuar con la API de Transkribus, primero debes autenticarte para obtener un token de acceso. La API utiliza el protocolo OpenID Connect para la autenticación. Aquí hay una guía paso a paso para obtener y administrar tus tokens de acceso.

Para algunas bibliotecas, puede que necesites la URL de configuración de OpenID Connect, que está disponible en: https://account.readcoop.eu/auth/realms/readcoop/.well-known/openid-configuration

1. Obtén un Token de Acceso

Utiliza el siguiente comando cURL, reemplazando $USERNAME y $PASSWORD con tus credenciales:

curl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/token \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode grant_type=password \
--data-urlencode username=$USERNAME \
--data-urlencode password=$PASSWORD \
--data-urlencode client_id=processing-api-client

Tras autenticación exitosa, recibirás un token de acceso en la respuesta. Además, recibirás un token de actualización que se puede usar para obtener un nuevo token de acceso una vez que el actual expire.

2. Refrescando el Token de Acceso

Si tu token de acceso expira, puedes usar el token de actualización proporcionado para obtener uno nuevo con este comando:

curl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/token \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode grant_type=refresh_token \
--data-urlencode client_id=processing-api-client \
--data-urlencode refresh_token=$REFRESH_TOKEN

Reemplaza $REFRESH_TOKEN con tu token de actualización. Actualiza tu token de actualización si la respuesta contiene uno nuevo.

3. Finalizando la Sesión

Para cerrar sesión e invalidar el token de actualización, utiliza:

curl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/logout \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode refresh_token=$REFRESH_TOKEN \
--data-urlencode client_id=processing-api-client

Información de Facturación

De forma predeterminada, la API de Transkribus utiliza el Sistema de Crédito interno de Transkribus para la facturación. Sin embargo, bajo solicitud, se puede arreglar un sistema de facturación de Pago por Uso.

Alojado en la UE

Las imágenes o páginas no se eliminan inmediatamente después del proceso de reconocimiento de texto manuscrito (HTR). Siguen la misma política de retención de 2 días mencionada anteriormente.

Sí, el modelo de precios es diferente debido a la no dependencia de la capacidad de almacenamiento. Para un desglose detallado, consulte el siguiente documento.

A partir de la versión ≥ 0.8.0, se aplican las mismas restricciones en el uso de modelos que en la plataforma Transkribus. Esto significa que las cuentas de API deben agregarse a colecciones donde se vinculan modelos privados para acceder.