> 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

Ces limitations 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 les limitations ou ne les respecte pas sera rejetée avec une erreur.

## Fichiers acceptés

### Fichiers PDF

Tous les fichiers au format Portable Document Format (PDF) peuvent être traités, qu'ils comportent une seule page ou 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 aussi fonctionner, tant que l'extension est `.pdf` et que le contenu binaire constitue 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 combiner des éléments de texte et d'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 limitation 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>Remarques</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>non animé uniquement</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é lors des tests, il est possible de téléverser des fichiers Zip vers le [Live test](/v2/fr/models/live-test.md).

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

### Limites de 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 Mo</td><td>100 Mo</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, des solutions de contournement sont disponibles 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.

Tous [fichiers acceptés](/v2/fr/integrations/technical-limitations.md#accepted-files) peuvent être utilisés, s'ils respectent 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é avec TLS (HTTPS).
* Publiquement accessible 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.\
  Par exemple, les URL signées Amazon S3 fonctionneront.
* Le contenu doit être un fichier binaire (octets bruts, **pas** encodé en base64).
* Le contenu du fichier ne peut pas être chiffré.
* Le serveur Mindee va **pas** suivre les redirections (HTTP 3xx).

## Limites de débit

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

Ces limites s'appliquent à l'ensemble d'une organisation, ce qui signifie la combinaison de tous les modèles, adresses IP d'origine et 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>Envoi 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.

{% hint style="success" %}
Si vous avez des besoins au-delà de 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* doit contenir uniquement :

* des lettres latines minuscules sans accents (a-z)
* des chiffres (0-9)
* des caractères de soulignement (`_`), mais ni le premier ni le dernier caractère ne peuvent être un caractère de soulignement.

## 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]: Groupe conjoint d'experts en photographie

[^2]: Graphiques réseau portables

[^3]: Format de fichier image balisé

[^4]: Conteneur d'images haute efficacité

[^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 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/technical-limitations.md?ask=<question>&goal=<endgoal>
```

`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.