> For the complete documentation index, see [llms.txt](https://docs.mindee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindee.com/v2/fr/integrations/client-libraries-sdk.md).
# Bibliothèques clientes / SDK
En utilisant les bibliothèques clientes, vous pourrez intégrer plus rapidement et réduire vos coûts de maintenance.
Quelques outils utiles sont également fournis, par exemple le traitement des PDF et la compression d’images.
Vous pouvez utiliser les bibliothèques clientes pour effectuer des requêtes API selon les schémas de polling et de webhook.
Toutes nos bibliothèques clientes sont open source (licence MIT) et hébergées sur [GitHub](https://github.com/mindee).
Langages/frameworks pris en charge : **Python**, **Node.js** (JS/TS), **PHP**, **Ruby**, **Java**, **.NET** (C#).
## Instructions d’installation
{% tabs %}
{% tab title="Python" %}
Nécessite Python ≥ 3.9. Python ≥ 3.11 est recommandé.
Installez simplement le [package PyPI](https://pypi.org/project/mindee/) avec `pip`:
```sh
pip install -U mindee~=5.1
```
{% endtab %}
{% tab title="Node.js" %}
Nécessite Node.js ≥ 20.1. Node.js ≥ 22 est recommandé.
Installez simplement le [package NPM](https://www.npmjs.com/package/mindee):
```sh
npm install mindee@^5.5.0
```
{% endtab %}
{% tab title="PHP" %}
Nécessite PHP ≥ 8.1. PHP ≥ 8.3 est recommandé.
Installez simplement le [package Packagist](https://packagist.org/packages/mindee/mindee) avec [composer](https://getcomposer.org/):
```sh
php composer.phar require "mindee/mindee:>=3.0"
```
{% endtab %}
{% tab title="Ruby" %}
Nécessite Ruby ≥ 3.2.
Installez simplement le [gem](https://rubygems.org/gems/mindee) avec :
```shell
gem install mindee -v '~> 5.2'
```
{% endtab %}
{% tab title="Java" %}
Nécessite Java ≥ 11. Java ≥ 17 est recommandé.
ID de groupe : `com.mindee.sdk`\
ID d’artefact : `mindee-api-java`\
Version : `5.2.0` ou supérieur
Il existe plusieurs méthodes d'installation, Maven, Gradle, etc. :
[Détails de l'installation](https://central.sonatype.com/artifact/com.mindee.sdk/mindee-api-java)
{% endtab %}
{% tab title=".NET" %}
.NET ≥ 8.0 est recommandé.
Installez simplement le [package NuGet](https://www.nuget.org/packages/Mindee) avec `dotnet add`:
```sh
dotnet add package Mindee --version 4.4
```
{% endtab %}
{% endtabs %}
Vous ne voyez pas de prise en charge pour votre langage ou framework préféré ? [Faites une demande de fonctionnalité !](https://feedback.mindee.com/?b=682f69c9e2404756e7e68d1c)
## Détails d’utilisation
Dans l’ensemble, les étapes pour utiliser le service Mindee sont :
1. [Configuration du client](/v2/fr/integrations/client-libraries-sdk/configure-the-client.md)
1. Initialisez le client Mindee.
2. Définissez les paramètres d’inférence, en particulier l’ID de modèle à utiliser.
2. [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md)
1. Chargez un fichier depuis diverses sources prises en charge : chemin, octets, etc.
2. *Facultatif*: ajustez le fichier source avant l’envoi.
3. [Envoyer un fichier ou une URL](/v2/fr/integrations/client-libraries-sdk/send-a-file-or-url.md)
1. Envoyez le fichier ou une URL avec les paramètres appropriés.
4. [Traitement des réponses](/v2/fr/integrations/client-libraries-sdk/process-the-response.md)
1. Facultatif : charger à partir d’un webhook.
2. Facultatif : accéder aux métadonnées du document
5. [Résultat d'extraction](/v2/fr/modeles-extraction/sdk-integration/extraction-result.md)
1. Traitez les valeurs des champs extraites du document
2. Facultatif : accéder aux métadonnées des champs (polygones, score de confiance)
## Questions fréquemment posées
Puis-je envoyer des requêtes en parallèle ?
Oui. Tous les clients peuvent être utilisés pour envoyer des requêtes en parallèle.
L’implémentation exacte est laissée à l’utilisateur :
* Pour Node.js, vous devrez utiliser un traitement asynchrone.
* Pour toutes les autres, vous devrez utiliser des threads ou des processus.
Puis-je utiliser les API v1 et v2 ensemble ?
Oui. Chaque bibliothèque cliente prend en charge les API v1 et v2.
Vous devrez créer une instance distincte des classes clientes :
* .NET et Java, utilisez `MindeeClient` et `MindeeClientV2`
* pour toutes les autres, utilisez `Client` et `ClientV2`
Le code pour effectuer des requêtes et traiter les résultats est **très différent** entre v1 et v2.
Nous recommandons vivement d’avoir des fichiers différents (voire des modules) pour gérer chaque version de l’API.
Puis-je envoyer uniquement une page précise d’un PDF multipage ?
Oui. Toutes les bibliothèques prennent en charge le découpage/l’extraction des pages PDF.
Pour plus d’informations, consultez : [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#manipulate-pdf-pages).
Comment empêcher l’envoi de PDF comportant trop de pages ?
**N’utilisez pas la taille du fichier**, un PDF textuel de 200 pages peut être plus petit qu’une seule photo.
Il est bien plus fiable de compter le nombre réel de pages du document PDF.
Utilisez les méthodes et propriétés de métadonnées de fichier intégrées pour ajouter facilement des règles métier basées sur le nombre de pages (entre autres données).
Pour plus d’informations, consultez : [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#source-file-metadata).
J’utilise une fonction edge Supabase, dois-je utiliser l’API directement ?
Nous recommandons d’utiliser la [bibliothèque cliente Node.js de Mindee](https://github.com/mindee/mindee-api-nodejs) dans Supabase.
Vous pouvez l’installer dans votre/vos fonction(s) edge à l’aide de `npm`.
Quelles fonctionnalités de la bibliothèque sont officiellement prises en charge ?
Tout ce qui est documenté ici est officiellement pris en charge et considéré comme stable pour une utilisation en production.
Tout élément d’une bibliothèque qui n’est pas documenté ici est **pas** officiellement pris en charge et peut être modifié ou supprimé.
Il y a un bogue avec le SDK, comment puis-je obtenir de l’aide ?
Si vous rencontrez un problème persistant, vous devriez d’abord essayer :
1. Demander de l’aide à l’Assistant Docs :
2. Demander de l’aide à votre agent local en utilisant l’un de nos [fichiers SKILL](/v2/fr/integrations/ai-coding-assistants.md#skill-files)
Après cela, si vous déterminez (ou si l’on vous indique) qu’il y a un problème avec le SDK lui-même, le mieux serait d’ouvrir un rapport de bogue sur le dépôt GitHub du SDK concerné :
* **Python**:
* **Node.js**:
* **PHP**:
* **Ruby**:
* **Java**:
* **.NET**:
Nos ingénieurs SDK seront automatiquement informés du nouveau problème.
**Remarque :** Les forfaits Pro et supérieurs peuvent contacter directement nos équipes d’assistance.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.mindee.com/v2/fr/integrations/client-libraries-sdk.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.