Guide technique · API FastAPI · Mars 2026
Addendum à la documentation pipeline v1.0 — interface Swagger, endpoints, tests aspirine & ibuprofène.
1 · Interface Swagger — Documentation interactive
Accès à l'interface OpenAPI 3.1. Quatre endpoints : GET /health, POST /v1/score-toxicity, GET /v1/score-toxicity, POST /v1/score-toxicity/batch. Huit schémas Pydantic documentés.
2 · Démarrage de l'API
Prérequis (conda ml, modèle, calibration, Delta Lake Silver). Commandes de démarrage Uvicorn. Séquence de chargement : modèle → calibration → fingerprints training set.
3 · Tests de validation — Résultats observés
Aspirine (résolution DCI PubChem, 2 017 ms) : NR-ER 0.350, LD50 200 mg/kg, Tanimoto 0.594. Ibuprofène (SMILES direct, 1 581 ms) : NR-PPAR-gamma 0.383 — signal pharmacologiquement validé. Comparaison croisée des deux profils.
4 · Format ScoreResponse
Huit champs de premier niveau : query, resolved, predictions, experimental_data, applicability_domain, calibration_warning, inference_time_ms, model_version. Grilles d'interprétation des scores et de l'incertitude.
Ce guide technique documente l'API FastAPI ToxTwin en production : interface Swagger, endpoints disponibles, schémas de données, et résultats de validation sur deux molécules de référence pharmaceutique. L'observation clé — le différentiel NR-PPAR-gamma entre aspirine et ibuprofène — constitue une validation fonctionnelle du modèle ToxGNN-V1.
Est-il soutenable économiquement ?
Est-il gouvernable dans la durée ?