Guide utilisateur

Comment utiliser SecuAI : une API IA souveraine compatible OpenAI — premiers appels, choix d'un modèle, anonymisation des données personnelles et facturation en CAD.

SecuAI en bref

SecuAI est une API d'intelligence artificielle souveraine compatible avec l'API d'OpenAI. Vous l'intégrez dans vos applications comme vous le feriez avec OpenAI : vous changez l'URL de base et votre clé, et vous réutilisez vos outils et SDK habituels.

Ce guide donne une vue d'ensemble. La documentation détaillée (référence API, guides par fonctionnalité, exemples de code) est accessible après connexion à votre compte.

Premiers pas

Obtenez une clé auprès de votre administrateur SecuAAS. Les clés SecuAI sont préfixées sk-secuai-.
Pointez votre client vers l'API SecuAI en changeant l'URL de base et la clé.
Faites votre premier appel avec le SDK OpenAI ou curl.

L'accès à SecuAI se fait sur invitation pendant la phase beta. Si vous n'avez pas de compte, contactez votre administrateur SecuAAS.

Compatible avec vos outils

Parce que l'API suit le format d'OpenAI, vous travaillez avec ce que vous connaissez déjà :

Le SDK OpenAI (Python, JavaScript, Go) en pointant simplement le base_url vers SecuAI.
Des appels curl directs.
Le streaming des réponses (SSE), pour les longues générations.
Le function calling (outils), sur les modèles qui le supportent.

Choisir un modèle

SecuAI propose plusieurs familles de modèles, classées par niveau de résidence des données. Le bon choix dépend de la sensibilité de vos données :

Données sensibles devant rester au Québec → un modèle souverain québécois (inférence sur GPU souverain à Beauharnois, Loi 25 stricte).
Charges générales avec résidence souveraine européenne → un modèle souverain européen (chat, code, vision, embeddings, transcription audio).
Besoins spécifiques exigeant un grand fournisseur cloud → modèles cloud, activés explicitement (opt-in) sur votre compte.

La liste exacte des modèles disponibles pour votre compte est fournie par l'endpoint de liste des modèles de l'API.

Anonymisation des données personnelles

SecuAI peut pseudonymiser les renseignements personnels (PII) d'un texte avant son envoi à un modèle. Les valeurs sensibles sont remplacées par des valeurs synthétiques réalistes, et la valeur originale ne traverse jamais le modèle.

Catégories couvertes (haut niveau) :

Identité : noms de personnes, dates de naissance.
Coordonnées : courriels, numéros de téléphone, adresses postales, codes postaux.
Identifiants gouvernementaux : NAS, RAMQ, permis de conduire.
Données financières : cartes de crédit, IBAN, comptes bancaires.
Identifiants techniques et organisationnels : adresses IP, MAC, numéros de compte ou de police, organisations, lieux.

Le flux typique est : anonymiser le texte, l'envoyer au modèle, puis ré-identifier la réponse si nécessaire (opération optionnelle et journalisée). La réversibilité repose sur un mapping chiffré, hébergé au Québec, avec une durée de vie configurable.

L'anonymisation est une fonctionnalité de compte (tenant). Selon votre configuration, elle peut s'appliquer automatiquement à vos appels ou être invoquée explicitement via l'API d'anonymisation.

Conformité et résidence

Loi 25 — la plateforme est conçue pour le traitement de renseignements personnels dans le respect de la réglementation québécoise.
Résidence québécoise — les modèles souverains s'exécutent au Québec ; toute persistance liée à l'anonymisation reste chiffrée et hébergée au Québec.
Journalisation des accès — les accès aux valeurs personnelles originales (ré-identification) sont journalisés à des fins d'audit.

Facturation

SecuAI facture en dollars canadiens (CAD). Les modalités exactes (abonnement, crédit prépayé, taxes du Québec) sont présentées dans votre espace de compte. La gestion de votre compte, de vos clés et de votre consommation se fait après connexion.