Rechercher...
  • Tarifs
Commencer

Commencez à taper pour rechercher parmi les modèles, sites et articles de blog...

Documentation de Metagrapho

Introduction

L'API Transkribus facilite le traitement des images à l'aide de la technologie Transkribus HTR (Handwritten Text Recognition). Avec cette API, les utilisateurs peuvent soumettre des images pour traitement et récupérer ultérieurement les résultats à l'aide du processId fourni.

Authentification

Pour interagir avec l'API Transkribus, vous devez d'abord vous authentifier pour obtenir un jeton d'accès. L'API utilise le protocole OpenID Connect pour l'authentification. Voici un guide étape par étape pour obtenir et gérer vos jetons d'accès.

Pour certaines bibliothèques, vous pourriez avoir besoin de l'URL de configuration OpenID Connect, qui est disponible à : https://account.readcoop.eu/auth/realms/readcoop/.well-known/openid-configuration

1. Obtenir un jeton d'accès

Utilisez la commande cURL suivante, en remplaçant $USERNAME et $PASSWORD par vos identifiants :

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

En cas d'authentification réussie, vous recevrez un jeton d'accès dans la réponse. De plus, vous recevrez un jeton d'actualisation qui peut être utilisé pour obtenir un nouveau jeton d'accès une fois que le jeton actuel expire.

2. Actualiser le jeton d'accès

Si votre jeton d'accès expire, vous pouvez utiliser le jeton d'actualisation fourni pour en obtenir un nouveau avec cette commande :

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

Remplacez $REFRESH_TOKEN par votre jeton d'actualisation. Mettez à jour votre jeton d'actualisation si la réponse en contient un nouveau.

3. Terminer la session

Pour vous déconnecter et invalider le jeton d'actualisation, utilisez :

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

Informations de facturation

Par défaut, l'API Transkribus utilise le système de crédit interne de Transkribus pour la facturation. Cependant, sur demande, un système de facturation à l'usage peut être convenu.

FAQ

Les pages soumises au point de terminaison restent accessibles jusqu'à 2 jours. Après cette période, vous recevrez une réponse `404 Not Found` si vous tentez d'y accéder.

Les images ou pages ne sont pas immédiatement supprimées après le processus de reconnaissance du texte manuscrit (HTR). Elles suivent la même politique de rétention de 2 jours que mentionnée ci-dessus.

Oui, le modèle de tarification est différent en raison de l'absence de dépendance à la capacité de stockage. Pour une ventilation détaillée, veuillez consulter le document suivant.

À partir de la version ≥ 0.8.0, les mêmes restrictions sur l'utilisation du modèle sont appliquées que sur la plateforme Transkribus. Cela signifie que les comptes API doivent être ajoutés aux collections où les modèles privés sont liés pour l'accès.