Guide
Document trop gros pour l'API : limites de pages et taille
Pages, mégaoctets et jetons maximum pour Claude, Gemini, Azure et Google Document AI, relevés le 15/11/2026, et comment découper un PDF trop lourd.
Mis à jour le
Un document refusé ou tronqué par une interface de programmation (API) dépasse en général l'une de trois limites : le nombre de pages, la taille en mégaoctets, ou la fenêtre de contexte du modèle, c'est-à-dire la quantité de texte qu'il peut lire d'un coup. Les deux premières sont écrites dans la documentation ; la troisième dépend de la densité du document. Voici les chiffres relevés le 15/11/2026, puis les façons de découper.
Les limites relevées
| Service | Pages | Taille | Remarques |
|---|---|---|---|
| API Claude, PDF | 600 par requête (100 si la fenêtre de contexte est inférieure à un million de jetons) | 128 Mo par requête | PDF standard, sans mot de passe ni chiffrement |
| API Claude, Files API | — | 500 Mo par fichier, 1 To par organisation | le contenu utilisé reste facturé en jetons d'entrée |
| API Claude, images | 600 images par requête (100 pour les modèles à 200 000 jetons) | 10 Mo par image, 8 000 × 8 000 pixels | au-delà de 20 images, limite de dimension plus stricte |
| API Gemini | 1 000 pages | 50 Mo, en ligne comme par Files API | fichiers conservés 48 heures |
| Azure Document Intelligence | 2 000 pages | 500 Mo (offre payante), 4 Mo (gratuite) | en gratuit, seules les deux premières pages |
| Google Document AI (OCR, Layout Parser) | 15 en ligne, 500 par lots | 40 Mo en ligne, 1 Go par lots | 30 pages en ligne en mode sans image |
| Microsoft Graph, conversion de format | — | 2 Mo | pour ?format=pdf notamment |
| Google Drive, export d'un Doc | — | 10 Mo | contenu exporté par files.export |
La limite cachée : la fenêtre de contexte
La documentation PDF de Claude prévient : un PDF dense (petites polices, tableaux complexes, beaucoup d'images) peut remplir la fenêtre de contexte avant d'atteindre la limite de pages, et une requête avec un gros PDF peut échouer avant cette limite, même par la Files API. Chaque page y coûte en général de 1 500 à 3 000 jetons de texte, plus le coût de l'image de la page, car chaque page est aussi convertie en image.
Côté Gemini, la documentation compte 258 jetons par page de document. Les grandes pages sont réduites à 3 072 × 3 072 pixels au plus, les petites agrandies à 768 × 768, en gardant les proportions.
Quatre façons de faire passer un gros document
- Découper par section, pas au nombre de pages : un chapitre, une annexe, un lot de factures. Chaque morceau garde le sens.
- Alléger les images : la documentation de Claude conseille de réduire la résolution des images intégrées, puisque chaque page est traitée comme une image.
- Convertir en texte d'abord : un PDF converti en Markdown par Docling ne paie plus le coût des images de page.
- Passer par un index : au-delà de quelques centaines de pages consultées régulièrement, l'indexation (RAG, génération augmentée par récupération) devient plus raisonnable que l'envoi du document entier. Voir la page sur le RAG appliqué aux PDF.
Découper un PDF en Python
La bibliothèque pypdf ajoute à un nouveau fichier une plage de pages d'un PDF existant :
from pypdf import PdfWriter
writer = PdfWriter()
writer.append("rapport-annuel.pdf", (0, 100)) # pages 1 à 100
writer.write("rapport-annuel-partie-1.pdf")
Gardez une trace du découpage (fichier d'origine, plage de pages) dans les métadonnées : la réponse doit pouvoir citer la page du document complet, pas celle du morceau. Voir Métadonnées.
Les services d'OCR : traiter seulement les pages utiles
Azure Document Intelligence accepte un paramètre pages pour n'analyser que certaines pages ou plages d'un long document. Marker, l'outil libre de conversion, propose de même --page_range. Pour une notice de 800 pages dont seules les annexes techniques comptent, c'est le moyen le plus simple de rester sous les limites et de payer moins.
Exemple illustratif
Prenons un appel d'offres public de 900 pages en un seul PDF : règlement, cahier des clauses, annexes, plans. Plutôt que de chercher la limite de chaque API, on le découpe en pièces selon le sommaire, on convertit chaque pièce en Markdown et on indexe : chaque réponse cite alors la pièce et la page d'origine.
Questions fréquentes
Combien de pages de PDF l'API de Claude accepte-t-elle ?
600 pages par requête, ou 100 quand la fenêtre de contexte de la requête est inférieure à un million de jetons, et 128 Mo par requête sur l'API d'Anthropic, d'après sa documentation relevée le 15/11/2026.
Quelle est la taille maximale d'un PDF pour Gemini ?
50 Mo ou 1 000 pages, que le fichier soit envoyé dans la requête ou par la Files API, d'après la documentation de Gemini relevée le 15/11/2026.
Sources
Pages consultées pour écrire cet article :
- https://platform.claude.com/docs/en/build-with-claude/pdf-support
- https://platform.claude.com/docs/en/build-with-claude/files
- https://platform.claude.com/docs/en/build-with-claude/vision
- https://aistudio.google.com/docs/document-processing
- https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/prebuilt/layout?view=doc-intel-4.0.0
- https://docs.cloud.google.com/document-ai/limits
- https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-1.0
- https://developers.google.com/workspace/drive/api/guides/manage-downloads
- https://pypdf.readthedocs.io/en/stable/user/merging-pdfs.html
- https://github.com/datalab-to/marker