Démarrage rapide - Locus

Il vous faut une clé API Locus — un jeton bearer de la forme lsk_<slug>_<random>. Voir Authentification.

URL de base utilisée ici : https://core.locusmedical.fr. Remplacez-la par l’URL de votre déploiement si elle diffère.

1. Poser une question

curl -X POST https://core.locusmedical.fr/v2/retrieve \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "antibioprophylaxie chirurgie colorectale"}'

import httpx

resp = httpx.post(
    "https://core.locusmedical.fr/v2/retrieve",
    headers={"Authorization": f"Bearer {LOCUS_API_KEY}"},
    json={"query": "antibioprophylaxie chirurgie colorectale"},
    timeout=120,
)
resp.raise_for_status()
data = resp.json()
print(data["answer"])          # Markdown, avec ses citations
print(data["trace_id"])        # à renvoyer sur /v2/feedback

const resp = await fetch("https://core.locusmedical.fr/v2/retrieve", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOCUS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "antibioprophylaxie chirurgie colorectale" }),
});
const { answer, trace_id } = await resp.json();

answer est du Markdown. La même route sait aussi rendre un document lisible directement, selon l’en-tête Accept :

curl -X POST https://core.locusmedical.fr/v2/retrieve \
  -H "Authorization: Bearer $LOCUS_API_KEY" \
  -H "Accept: text/markdown" \
  -H "Content-Type: application/json" \
  -d '{"query": "antibioprophylaxie chirurgie colorectale"}'

2. Diffuser l’avancée dans votre interface

Une réponse se construit en plusieurs étapes lourdes. Pour ne pas laisser l’utilisateur devant une barre qui invente sa progression, appelez /v2/retrieve/stream : une ligne JSON par étape réellement terminée, puis une ligne done portant la payload complète.

3. Essayer dans le playground

L’onglet API Reference affiche chaque endpoint avec un playground interactif. Cliquez sur Authorization, collez votre clé lsk_…, et lancez une requête sans quitter la documentation.

Étapes suivantes

Authentification

Format de clé, hachage, quotas.

Capacités

Ce que fait chaque endpoint et quand l’utiliser.