Aller au contenu

Documentation

Documents

2 opérations servies.

Document mis en forme (PDF ou Word)

POST/api/v1/documents

Met en forme un document à partir des sections fournies (titres, paragraphes, puces, tableaux, sources) et le rend en PDF ou en Word : rapport, lettre, compte rendu, check-list, note ou comparatif. Aucun modèle de langage : le contenu vient de l'appelant. Le texte entre doubles astérisques est mis en gras dans le Word. La réponse JSON (et le contenu structuré du MCP) décrit le fichier, dont le texte brut sans coordonnées ; le fichier, lui, garde le contenu fourni.

Coût
2 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
documents
Outil MCP
generer_document
Bac à sable
Non
Mémoire
Jamais gardée
Délai
15 s

Essayer en direct

Paramètres

  • typetexteobligatoire

    Valeurs : rapport, lettre, compte_rendu, checklist, note, comparatif

  • titretexteobligatoire

    de 1 à 4 000 caractères

  • sous_titretexte

    4 000 caractères au plus

  • destinatairetexte

    4 000 caractères au plus

  • datetexte

    200 caractères au plus

  • sectionsliste d'objetsobligatoire

    1 éléments au moins ; 20 éléments au plus

    Afficher les 4 champs
    • titretexte

      4 000 caractères au plus

    • paragraphesliste de textes

      40 éléments au plus

    • pucesliste de textes

      40 éléments au plus

    • tableauobjet
      Afficher les 2 champs
      • colonnesliste de textesobligatoire

        1 éléments au moins ; 12 éléments au plus

      • lignesliste de liste de textessobligatoire

        200 éléments au plus

  • sourcesliste de textes

    20 éléments au plus

  • formattexte

    Valeurs : pdf, docx

    par défaut "pdf"

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/documents \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"type":"rapport","titre":"<titre>","sections":[{}]}'

Réponse

  • typetexte
  • titretexte
  • formattexte

    Valeurs : pdf, docx

  • type_fichiertexte
  • nom_fichiertexte
  • taille_octetsentier
  • sectionsentier
  • a_completerentier

    Mentions « à compléter » laissées dans le document.

  • textetexte

    Le document en texte brut, coordonnées remplacées par une mention.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Lecture de documents par le modèle

POST/api/v1/documents/lectures

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
Accès
À l'usage ou avec l'abonnement Data
Portée
documents
Outil MCP
lire_document
Bac à sable
Non
Mémoire
Jamais gardée
Délai
120 s

Essayer en direct

Paramètres

  • fichiersliste d'objetsobligatoire

    1 éléments au moins ; 5 éléments au plus

    Afficher les 3 champs
    • nomtexte

      Nom du fichier, pour le citer.

      200 caractères au plus

    • urltexte

      Lien https public du fichier (PDF ou image), téléchargé par Pillr.

      2 000 caractères au plus ; adresse web

    • contenu_base64texte

      Contenu du fichier en base64, dans la limite de taille du corps d'une requête.

      60 000 caractères au plus

  • questiontexteobligatoire

    de 3 à 2 000 caractères

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/documents/lectures \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"fichiers":[{}],"question":"<question>"}'

Réponse

  • reponsetexte
  • faitsliste d'objets
    Afficher les 4 champs
    • faittexte
    • documenttexte ou null
    • pageentier ou null
    • citationtexte ou null
  • referencesliste d'objets
    Afficher les 3 champs
    • nomtexte
    • typetexte
    • echeancetexte ou null
  • documentsliste d'objets
    Afficher les 4 champs
    • nomtexte
    • typetexte

      Valeurs : pdf, image

    • pagesentier ou null
    • taille_octetsentier
  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

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

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

    Documents : référence de l'API | Pillr Data