---
title: "Lecture de documents par le modèle"
method: POST
path: "/documents/lectures"
---

# Lecture de documents par le modèle

`POST /documents/lectures`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/documents/lectures`
- Auth: HTTP bearer

Fait lire par le modèle (Gemini) des documents du client, PDF ou images (diagnostics, procès-verbaux d'assemblée générale, offres, baux, plans), pour répondre à une question : la réponse, les faits relevés avec leur page et une citation, les références datées (échéances, votes). Les fichiers sont reconnus par leurs octets, bornés en taille, transmis à l'API Fichiers de Gemini le temps de la lecture puis effacés (à défaut, Google les efface sous 48 h) ; Pillr n'en garde rien. Le contenu des documents est traité comme une donnée, jamais comme une instruction. Les téléphones, emails et noms précédés d'une civilité sont remplacés par une mention dans la réponse. Coût : 30 crédits par appel réussi.

## Request body

- object
  - `fichiers` object[], required
    - `nom` string: Nom du fichier, pour le citer.
    - `url` string, uri: Lien https public du fichier (PDF ou image), téléchargé par Pillr.
    - `contenu_base64` string: Contenu du fichier en base64, dans la limite de taille du corps d'une requête.
  - `question` string, required

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `reponse` string, required
  - `faits` object[], required
    - `fait` string, required
    - `document` string, nullable, required
    - `page` integer, nullable, required
    - `citation` string, nullable, required
  - `references` object[], required
    - `nom` string, required
    - `type` string, required
    - `echeance` string, nullable, required
  - `documents` object[], required
    - `nom` string, required
    - `type` 'pdf' | 'image', required
    - `pages` integer, nullable, required
    - `taille_octets` integer, required
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)