Aller au contenu
Cercle IA Tech · Documents Un site du réseau Cercle IA Tech

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

  1. Découper par section, pas au nombre de pages : un chapitre, une annexe, un lot de factures. Chaque morceau garde le sens.
  2. 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.
  3. Convertir en texte d'abord : un PDF converti en Markdown par Docling ne paie plus le coût des images de page.
  4. 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 :

  1. https://platform.claude.com/docs/en/build-with-claude/pdf-support
  2. https://platform.claude.com/docs/en/build-with-claude/files
  3. https://platform.claude.com/docs/en/build-with-claude/vision
  4. https://aistudio.google.com/docs/document-processing
  5. https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/prebuilt/layout?view=doc-intel-4.0.0
  6. https://docs.cloud.google.com/document-ai/limits
  7. https://learn.microsoft.com/en-us/graph/api/driveitem-get-content-format?view=graph-rest-1.0
  8. https://developers.google.com/workspace/drive/api/guides/manage-downloads
  9. https://pypdf.readthedocs.io/en/stable/user/merging-pdfs.html
  10. https://github.com/datalab-to/marker

À lire aussi