Démarrage rapide

Une clé d'API, puis une première question citée.

1. Obtenir une clé d'API#

Créez un compte ou connectez-vous.
Dans Clés d'API (/app/keys), créez une clé (un nom, une limite de requêtes par minute facultative).
Copiez-la: elle n'est affichée qu'une fois.

bash

export SEXTANT_API=https://api.example.com

export SEXTANT_API_KEY=sextant_...

2. Poser une première question#

bash

curl -s "$SEXTANT_API/v1/ask" \

  -H "authorization: Bearer $SEXTANT_API_KEY" \

  -H "content-type: application/json" \

  -d '{"sources": "https://example.com/rapport-annuel.pdf", "question": "Quel est le plafond de rémunération du PDG ?"}'

La réponse (answer) cite ses preuves (evidence): citation, emplacement, lien. Tous les champs: POST /v1/ask.

3. Ajouter un fichier#

bash

curl -s "$SEXTANT_API/v1/sources" -H "authorization: Bearer $SEXTANT_API_KEY" -F "file=@contrat.pdf"

Passez ensuite source.id (src_…) dans sources. Gros fichier: -F "wait=false" (Imports).

4. Utiliser un SDK#

Python

import os
from sextant.sdk import Sextant

client = Sextant(base_url=os.environ["SEXTANT_API"], api_key=os.environ["SEXTANT_API_KEY"])
r = client.ask("https://example.com/rapport-annuel.pdf", "Quel est le plafond de rémunération du PDG ?")
print(r["answer"], r["evidence"][0]["link"])

Installation et TypeScript: SDK.

5. Poser une relance#

Renvoyez le thread_id; sans source, la relance cherche dans les sources du thread.

bash

curl -s "$SEXTANT_API/v1/ask" \

  -H "authorization: Bearer $SEXTANT_API_KEY" \

  -H "content-type: application/json" \

  -d '{"thread_id": "thr_…", "question": "Et pour les autres dirigeants ?"}'

6. Suivre la progression en streaming#

Ajoutez "stream": true:

bash

curl -N "$SEXTANT_API/v1/ask" \

  -H "authorization: Bearer $SEXTANT_API_KEY" \

  -H "content-type: application/json" \

  -d '{"sources": "https://example.com/rapport-annuel.pdf", "question": "Quel est le plafond de rémunération du PDG ?", "stream": true}'

text/event-stream

event: evidence_found

data: {"t_ms": 1480.0, "evidence_id": "ev_…", "label": "p. 847", "quote": "…à 4,2 millions d'euros…", "confidence": 0.9}



event: answer_delta

data: {"t_ms": 1710.3, "text": "Pour 2026, la rémunération annuelle"}



event: result

data: {"answer": "…", "status": "answered", "evidence": […], "billing": {"price_usd": 0.006}}



event: done

data: {}

Tous les événements: Streaming.