> 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/technical-limitations.md).

# Limitations techniques

Limitations techniques lors de l’intégration de Mindee.

Ces limites sont conçues pour garantir la sécurité et la stabilité de l’API et de la plateforme Mindee.

Sauf indication contraire, toute action qui dépasse ou ne respecte pas les limites sera rejetée avec une erreur.

## Fichiers acceptés

### Fichiers PDF

Tous les fichiers au format PDF (PDF) peuvent être traités, qu’il s’agisse d’une seule page ou de plusieurs pages.

Ils sont définis à l’aide du `application/pdf` Type de média.

Dans certains cas `application/binary` est utilisé ; c’est incorrect selon la norme, mais cela devrait également fonctionner, tant que l’extension est `.pdf` et que le contenu binaire est un fichier PDF valide.

Dans de rares cas, les en-têtes PDF sont corrompus ou invalides. Corrigez-les à l’aide de notre [outil de réparation PDF](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#fix-pdf-headers), sinon le serveur peut les rejeter.

Chaque page PDF peut être une combinaison d’éléments textuels et d’éléments image.

{% hint style="warning" %}
**Les fichiers PDF ne peuvent pas être protégés par mot de passe.**

Le serveur n’essaiera pas d’ouvrir un fichier protégé par mot de passe ; cette limite inclut donc les mots de passe vides ou vierges.
{% endhint %}

### Fichiers image

La plupart des types d’images courants peuvent être traités.

Plus précisément, nous acceptons les types d’images suivants :

<table><thead><tr><th width="140">Type</th><th width="158.5">Type de média</th><th width="135.5">Extensions</th><th>Notes</th></tr></thead><tbody><tr><td><a data-footnote-ref href="#user-content-fn-1">JPEG</a></td><td>image/jpeg</td><td>jpeg, jpg</td><td></td></tr><tr><td><a data-footnote-ref href="#user-content-fn-2">PNG</a></td><td>image/png</td><td>png</td><td>uniquement non animées</td></tr><tr><td>WebP</td><td>image/webp</td><td>webp</td><td></td></tr><tr><td><a data-footnote-ref href="#user-content-fn-3">TIFF</a></td><td>image/tiff</td><td>tiff, tif</td><td>une seule page ou plusieurs pages</td></tr><tr><td><a data-footnote-ref href="#user-content-fn-4">HEIC</a></td><td>image/heic</td><td>heic</td><td></td></tr><tr><td><a data-footnote-ref href="#user-content-fn-5">HEIF</a></td><td>image/heif</td><td>heif</td><td>Une seule image encodée en HEVC uniquement.</td></tr></tbody></table>

### Fichiers Zip

Par commodité pour les tests, il est possible de téléverser des fichiers Zip dans le [Live test](/v2/fr/models/live-test.md).

L’API ne prend pas en charge l’envoi de fichiers Zip.

### Limites des fichiers de l’API

Ces limites s’appliquent à tous les fichiers envoyés à l’API, quel que soit leur type.

<table><thead><tr><th width="170.800048828125">Type de limite</th><th width="152.7999267578125">Tous les forfaits payants</th><th width="162.4000244140625">Essai gratuit</th></tr></thead><tbody><tr><td>Taille du fichier</td><td>100 MB</td><td>100 MB</td></tr><tr><td>Nombre de pages</td><td>Aucune limite</td><td>10 pages</td></tr></tbody></table>

Si vous avez accès au fichier localement, il existe des solutions de contournement pour ces limites :

* [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#manipulate-pdf-pages)
* [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#compress-files)

Nécessite d’utiliser notre [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md).

### Limites de fichiers du Live test

Ces limites s’appliquent aux fichiers envoyés au [Live test](/v2/fr/models/live-test.md).

<table><thead><tr><th width="170.800048828125">Type de limite</th><th width="152.7999267578125">Tous les forfaits payants</th><th width="162.4000244140625">Essai gratuit</th></tr></thead><tbody><tr><td>Taille du fichier du document</td><td>50 Mo</td><td>50 Mo</td></tr><tr><td>Nombre de pages</td><td>50 pages</td><td>10 pages</td></tr><tr><td>Taille du fichier ZIP</td><td>100 Mo</td><td>100 Mo</td></tr></tbody></table>

## URL acceptées

Il est possible d’envoyer une URL plutôt que des données binaires à l’API.

Une URL pointant vers tous les [fichiers acceptés](/v2/fr/integrations/technical-limitations.md#accepted-files) peut être utilisée, si elle respecte les [limites de fichiers de l'API](/v2/fr/integrations/technical-limitations.md#api-file-limits).

De plus, l'URL source doit respecter les règles suivantes :

* Sécurisée à l'aide de TLS (HTTPS).
* Accessible publiquement à l'aide uniquement de l'URL, sans authentification *en-têtes*.
* L'authentification peut être fournie dans l'URL sous forme de paramètres de requête : nom d'utilisateur+mot de passe ou jeton.\
  Par exemple, les URL signées Amazon S3 fonctionneront.
* Le contenu doit être un fichier binaire (octets bruts, **pas** encodés en base64).
* Le contenu du fichier ne peut pas être chiffré.
* Le serveur Mindee va **pas** suivre les redirections (HTTP 3xx).

L’envoi d’une URL au Live test n’est pas pris en charge.

## Limites de débit

Les appels en rafale à l’API Mindee sont limités afin de garantir la stabilité de la plateforme pour tous les utilisateurs.

Ces limites de débit s’appliquent à une organisation entière, ce qui signifie la combinaison de tous les modèles, des IP sources et des clés API.

Les limites suivantes sont appliquées :

<table><thead><tr><th width="254">Type de limite</th><th>Valeur de la limite</th></tr></thead><tbody><tr><td>Envoyer pour traitement (POST)</td><td>200 requêtes par minute</td></tr><tr><td>Interrogation (GET)</td><td>1200 requêtes par minute<br><em>Normalement, cela est géré par la bibliothèque cliente.</em></td></tr></tbody></table>

Si les limites de débit sont dépassées, le serveur renverra une erreur HTTP 429.

Cependant, il n’y a aucune limite au **nombre total de fichiers** envoyés, tant qu’ils respectent les limites de débit.

{% hint style="success" %}
Utilisateurs Enterprise : si vos besoins dépassent ces limites, contactez [l’équipe commerciale](mailto:hello@mindee.com) pour une solution personnalisée.
{% endhint %}

## Schéma de données

### Nombre de champs dans le Schéma de données

Le nombre maximal recommandé de champs est de 25 pour un Schéma de données.

Bien qu'il n'y ait aucune erreur, au-delà de ce nombre, les temps de réponse augmenteront.

### Noms des champs

Le champ *nom* ne doit contenir que :

* des lettres latines minuscules sans accents (a-z)
* des chiffres (0-9)
* des tirets bas (`_`), mais ni le premier ni le dernier caractère ne peuvent être un tiret bas.
* les noms suivants ne peuvent pas être utilisés : `valeur`, `champs`, `éléments`.

## Webhooks

Les URL de webhook doivent respecter les règles suivantes :

* Sécurisé à l'aide de TLS (HTTPS).
* Disponible publiquement en utilisant uniquement l'URL, sans authentification *en-têtes*.
* L'authentification peut être fournie dans l'URL sous forme de paramètres de requête : nom d'utilisateur+mot de passe ou jeton
* Le serveur Mindee va **y aura pas** suivre les redirections (HTTP 3xx).
* La route doit renvoyer OK (HTTP 2xx) en cas de réussite.

[^1]: Joint Photographic Experts Group

[^2]: Portable Network Graphics

[^3]: Tag Image File Format

[^4]: High-Efficiency Image Container

[^5]:


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mindee.com/v2/fr/integrations/technical-limitations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.