API et authentification

Aperçu de l'API SecuAI : une API compatible OpenAI, souveraine et hébergée au Québec — authentification par clé, endpoints et compatibilité avec le SDK OpenAI.

Une API compatible OpenAI

L'API SecuAI suit le format d'OpenAI. Pour l'utiliser, vous changez l'URL de base de votre client et votre clé : le reste de votre code reste inchangé. Vous réutilisez le SDK OpenAI (Python, JavaScript, Go), curl ou tout autre client compatible.


Compatibilité	API OpenAI (chat completions, embeddings, transcription audio, liste des modèles)
Authentification	Clé `sk-secuai-…` via l'en-tête `Authorization: Bearer`
Hébergement	OVH Beauharnois (Québec) pour les modèles souverains
Format des erreurs	Enveloppe OpenAI `{ "error": { … } }`
Facturation	En dollars canadiens (CAD)

Authentification

L'authentification programmatique se fait par clé SecuAI, préfixée sk-secuai-, transmise dans l'en-tête standard :

Authorization: Bearer sk-secuai-VOTRE_CLE

Vos clés sont émises et gérées depuis votre espace de compte (accessible après connexion). Ne partagez jamais une clé et stockez-la comme un secret.

Endpoints principaux

L'API expose les endpoints familiers du format OpenAI :

Chat completions — génération de texte conversationnelle, avec streaming et function calling sur les modèles compatibles.
Embeddings — vectorisation de texte (recherche sémantique, RAG).
Transcription audio — conversion de l'audio en texte.
Liste des modèles — modèles accessibles à votre clé.
Anonymisation — pseudonymisation des renseignements personnels (PII) avant l'envoi à un modèle, avec ré-identification optionnelle.

La référence API complète (paramètres, exemples de requêtes et de réponses pour chaque endpoint) est disponible après connexion à votre compte.

Exemple — SDK OpenAI (Python)

from openai import OpenAI

client = OpenAI(
    api_key="sk-secuai-VOTRE_CLE",
    base_url="https://api.secuai.secuaas.com/v1",
)

response = client.chat.completions.create(
    model="secuai-local-large",
    messages=[
        {"role": "user", "content": "Bonjour, explique-moi la Loi 25 en une phrase."}
    ],
)
print(response.choices[0].message.content)

Exemple — curl

curl https://api.secuai.secuaas.com/v1/chat/completions \
  -H "Authorization: Bearer sk-secuai-VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "secuai-local-large",
    "messages": [
      {"role": "user", "content": "Bonjour ! Présente-toi en une phrase."}
    ]
  }'

Choisir un modèle

Le champ model de vos requêtes accepte un identifiant public secuai-…. Les modèles sont classés par niveau de résidence (souverain québécois, souverain européen, cloud opt-in). La liste exacte autorisée pour votre clé est toujours retournée par l'endpoint de liste des modèles.

Souveraineté et conformité

Modèles souverains québécois — inférence au Québec (GPU souverain OVH Beauharnois) pour vos données sensibles.
Anonymisation PII — protégez les renseignements personnels avant l'envoi à un modèle ; la valeur originale ne traverse jamais le modèle.
Loi 25 — plateforme conçue pour le traitement conforme des renseignements personnels.
Facturation CAD — coûts et facturation en dollars canadiens.