Guide technique · API FastAPI · Mars 2026

ToxTwin API — Tests de validation et guide d'utilisation

Addendum à la documentation pipeline v1.0 — interface Swagger, endpoints, tests aspirine & ibuprofène.

« Le signal NR-PPAR-gamma à 0.383 pour l'ibuprofène, absent chez l'aspirine (0.038), correspond à une relation structure-activité documentée. Le modèle ToxGNN-V1 a capturé cette différence pharmacologique sans supervision explicite. »

Contenu du guide

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.

Document complet

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.

ToxTwin API — Tests de validation · Mars 2026 ↓ Télécharger PDF

Le lecteur PDF n'est pas disponible sur cet appareil.

↓ Télécharger le PDF

Votre système d'IA est performant.
Est-il déployable ?

Est-il soutenable économiquement ?
Est-il gouvernable dans la durée ?