> ## Documentation Index
> Fetch the complete documentation index at: https://docs.locusmedical.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Les modèles de rédaction disponibles

> Les valeurs admises par `answer_model` de `POST /v2/retrieve`, sous leur forme qualifiée `fournisseur:modèle`. Interrogé à chaud auprès de chaque fournisseur configuré (`GET /v1/models`) et mémorisé une heure — ce n'est donc pas une liste tenue à la main, qui vieillirait entre deux déploiements.

Le modèle marqué `default` est celui que le serveur emploie sans consigne. Un fournisseur injoignable est absent de la liste sans faire échouer la route : deux vendeurs configurés et un seul debout rendent la moitié du catalogue.

La liste n'est pas une validation : `answer_model` accepte toujours un identifiant absent d'ici — une passerelle peut servir un nom que `/v1/models` ne publie pas.



## OpenAPI

````yaml /openapi.json get /v2/models
openapi: 3.1.0
info:
  title: Locus API
  description: >-
    Locus knowledge layer — REST over a clinical knowledge graph.


    Two categories of surface:

    - **query** (read) — `/v2/retrieve` and `/v2/retrieve/stream`
    (knowledge-graph retrieval, MKF 0.1.3), `/v2/drugs/*` (the full text of an
    SmPC section a retrieval truncated) and `/v2/feedback` (a thumb on a traced
    answer);

    - **ops** — `/health`.


    The write plane (PDF → Neo4j graph: ingest, summarize, MKU extraction) is
    NOT exposed over HTTP — it is a batch pipeline driven by the `locus` CLI,
    which runs where the source PDFs are.
  version: 0.5.0
servers:
  - url: https://core.locusmedical.fr
    description: Production
security: []
paths:
  /v2/models:
    get:
      tags:
        - query
      summary: Les modèles de rédaction disponibles
      description: >-
        Les valeurs admises par `answer_model` de `POST /v2/retrieve`, sous leur
        forme qualifiée `fournisseur:modèle`. Interrogé à chaud auprès de chaque
        fournisseur configuré (`GET /v1/models`) et mémorisé une heure — ce
        n'est donc pas une liste tenue à la main, qui vieillirait entre deux
        déploiements.


        Le modèle marqué `default` est celui que le serveur emploie sans
        consigne. Un fournisseur injoignable est absent de la liste sans faire
        échouer la route : deux vendeurs configurés et un seul debout rendent la
        moitié du catalogue.


        La liste n'est pas une validation : `answer_model` accepte toujours un
        identifiant absent d'ici — une passerelle peut servir un nom que
        `/v1/models` ne publie pas.
      operationId: models_v2_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/LlmModel'
                type: array
                title: Response Models V2 Models Get
      security:
        - lsk: []
components:
  schemas:
    LlmModel:
      properties:
        id:
          type: string
          title: Id
          description: >-
            La valeur à passer dans `answer_model`, sous sa forme qualifiée
            `fournisseur:modèle` — ex. « scaleway:glm-5.2 ». Qualifiée même pour
            le fournisseur par défaut : c'est la seule forme qui reste juste
            quand deux vendeurs sont joignables à la fois.
        provider:
          type: string
          title: Provider
          description: Le fournisseur qui le sert — ex. « mistral ».
        model:
          type: string
          title: Model
          description: L'identifiant nu chez ce fournisseur.
        default:
          type: boolean
          title: Default
          description: >-
            Vrai pour le modèle que le serveur emploie sans consigne
            (`RETRIEVE_ANSWER_MODEL`).
          default: false
      type: object
      required:
        - id
        - provider
        - model
      title: LlmModel
      description: >-
        Un modèle de rédaction disponible, tel que `GET /v2/models` le publie.


        Le pendant de `RetrieveSource` pour `answer_model` : la liste vient des

        fournisseurs eux-mêmes (`/v1/models`), pas d'une liste tenue à la main
        qui

        vieillirait entre deux déploiements.
  securitySchemes:
    lsk:
      type: http
      description: Locus API key — paste the raw `lsk_…` value (no 'Bearer ' prefix).
      scheme: bearer

````