API Reference

Sancti API

Name: Sancti
Rating: 4.9 (240 reviews)
Author: Sancti

L'API Sancti est compatible avec le format OpenAI. Si vous utilisez déjà l'API OpenAI, changez juste la baseURL — ça marche.

Compatible OpenAI

Drop-in replacement

Local ou Cloud

Vous choisissez

Clé API simple

Un token par app

BASE URL

https://api.sancti.app/v1

ou http://localhost:3001/v1 en local

Authentification

Toutes les requêtes nécessitent un header Authorization.

Header d'authentification

bash

Authorization: Bearer sk-sancti-YOUR_API_KEY

Obtenez votre clé depuis sancti settings → API Keys.

Test de connexion

bash

curl https://api.sancti.app/v1/models \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY"

Chat Completions

Endpoint principal, compatible OpenAI /chat/completions.

POST

/v1/chat/completions

Crée une complétion de conversation

Requête simple

bash

curl https://api.sancti.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -d '{
    "model": "sancti-1",
    "messages": [
      { "role": "user", "content": "Explique les closures en JavaScript" }
    ]
  }'

Réponse

json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "sancti-1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Une closure en JavaScript est une fonction qui..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 87,
    "total_tokens": 99
  }
}

Paramètres

modelstringrequisID du modèle (sancti-1, sancti-flash, ou tout modèle Ollama)

messagesarrayrequisListe des messages. Chaque message: {role, content}

streambooleanoptionnelActive le streaming SSE (défaut: false)

temperaturenumberoptionnelCréativité 0–2 (défaut: 0.7)

max_tokensintegeroptionnelLimite de tokens dans la réponse

systemstringoptionnelPrompt système (raccourci Sancti)

memorybooleanoptionnelActive la mémoire persistante Sancti (défaut: false)

Modèles

Listez et interrogez les modèles disponibles.

GET

/v1/models

Liste tous les modèles disponibles

GET

/v1/models/{model_id}

Détails d'un modèle spécifique

Modèles Sancti natifs

json

{
  "data": [
    { "id": "sancti-auto",  "type": "chat", "provider": "sancti" },
    { "id": "sancti-1",     "type": "chat", "provider": "sancti" },
    { "id": "sancti-flash", "type": "chat", "provider": "sancti" },
    { "id": "sancti-code",  "type": "code", "provider": "sancti" },
    // + tous vos modèles Ollama locaux
  ]
}

Mémoire & Contexte

L'API Mémoire permet de lire et écrire dans le graphe de connaissance Sancti.

GET

/v1/memory

Récupère les souvenirs pertinents pour un contexte donné

POST

/v1/memory

Ajoute un nouveau souvenir

DELETE

/v1/memory/{id}

Supprime un souvenir spécifique

GET

/v1/memory/search

Recherche sémantique dans la mémoire

Recherche sémantique

bash

curl https://api.sancti.app/v1/memory/search \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -G --data-urlencode "q=préférences de code" \
  --data-urlencode "limit=5"

Agents

Déclenchez et orchestrez les agents CODAO via l'API.

GET

/v1/agents

Liste les agents disponibles et leur statut

POST

/v1/agents/{id}/run

Lance un agent sur un fichier ou contexte

GET

/v1/agents/bus

SSE — flux d'événements du Cognitive Bus

Lancer l'agent Sécurité

bash

curl https://api.sancti.app/v1/agents/security/run \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "auth/jwt.ts",
    "mode": "scan"
  }'

Streaming

Activez le streaming avec stream: true — réponses en temps réel via SSE.

Streaming avec le SDK TypeScript

typescript

import { SanctiClient } from '@sancti/sdk';

const sancti = new SanctiClient({ apiKey: process.env.SANCTI_API_KEY });

const stream = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Écris une fonction de tri en Rust' }],
  stream: true,
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content || '';
  process.stdout.write(delta);
}

Erreurs

L'API retourne des erreurs au format standard JSON.

400bad_requestParamètre invalide ou manquant

401unauthorizedClé API manquante ou invalide

404model_not_foundLe modèle demandé n'existe pas

429rate_limit_exceededTrop de requêtes — réessayez après le header Retry-After

500internal_errorErreur serveur — contactez le support

503model_unavailableModèle local indisponible (Ollama non démarré ?)

SDK TypeScript

SDK officiel — compatible Node.js et navigateur.

Installation

bash

npm install @sancti/sdk
# ou
pnpm add @sancti/sdk

Usage complet

typescript

import { SanctiClient } from '@sancti/sdk';

const sancti = new SanctiClient({
  apiKey: process.env.SANCTI_API_KEY,
  baseURL: 'https://api.sancti.app/v1', // ou localhost:3001/v1
});

// Chat simple
const res = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Hello' }],
});

// Avec mémoire persistante
const res2 = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Tu te souviens de moi ?' }],
  memory: true,
  userId: 'user-123',
});

// Lister les modèles
const models = await sancti.models.list();

Prêt à intégrer Sancti ?

Essayez l'API dans le playground ou téléchargez le SDK.

Essayer le Playground SDK sur GitHub

API Reference

Sancti API

L'API Sancti est compatible avec le format OpenAI. Si vous utilisez déjà l'API OpenAI, changez juste la baseURL — ça marche.

Compatible OpenAI

Drop-in replacement

Local ou Cloud

Vous choisissez

Clé API simple

Un token par app

BASE URL

https://api.sancti.app/v1

ou http://localhost:3001/v1 en local

Authentification

Toutes les requêtes nécessitent un header Authorization.

Header d'authentification

bash

Authorization: Bearer sk-sancti-YOUR_API_KEY

Obtenez votre clé depuis sancti settings → API Keys.

Test de connexion

bash

curl https://api.sancti.app/v1/models \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY"

Chat Completions

Endpoint principal, compatible OpenAI /chat/completions.

POST

/v1/chat/completions

Crée une complétion de conversation

Requête simple

bash

curl https://api.sancti.app/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -d '{
    "model": "sancti-1",
    "messages": [
      { "role": "user", "content": "Explique les closures en JavaScript" }
    ]
  }'

Réponse

json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "sancti-1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Une closure en JavaScript est une fonction qui..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 87,
    "total_tokens": 99
  }
}

Paramètres

modelstringrequisID du modèle (sancti-1, sancti-flash, ou tout modèle Ollama)

messagesarrayrequisListe des messages. Chaque message: {role, content}

streambooleanoptionnelActive le streaming SSE (défaut: false)

temperaturenumberoptionnelCréativité 0–2 (défaut: 0.7)

max_tokensintegeroptionnelLimite de tokens dans la réponse

systemstringoptionnelPrompt système (raccourci Sancti)

memorybooleanoptionnelActive la mémoire persistante Sancti (défaut: false)

Modèles

Listez et interrogez les modèles disponibles.

GET

/v1/models

Liste tous les modèles disponibles

GET

/v1/models/{model_id}

Détails d'un modèle spécifique

Modèles Sancti natifs

json

{
  "data": [
    { "id": "sancti-auto",  "type": "chat", "provider": "sancti" },
    { "id": "sancti-1",     "type": "chat", "provider": "sancti" },
    { "id": "sancti-flash", "type": "chat", "provider": "sancti" },
    { "id": "sancti-code",  "type": "code", "provider": "sancti" },
    // + tous vos modèles Ollama locaux
  ]
}

Mémoire & Contexte

L'API Mémoire permet de lire et écrire dans le graphe de connaissance Sancti.

GET

/v1/memory

Récupère les souvenirs pertinents pour un contexte donné

POST

/v1/memory

Ajoute un nouveau souvenir

DELETE

/v1/memory/{id}

Supprime un souvenir spécifique

GET

/v1/memory/search

Recherche sémantique dans la mémoire

Recherche sémantique

bash

curl https://api.sancti.app/v1/memory/search \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -G --data-urlencode "q=préférences de code" \
  --data-urlencode "limit=5"

Agents

Déclenchez et orchestrez les agents CODAO via l'API.

GET

/v1/agents

Liste les agents disponibles et leur statut

POST

/v1/agents/{id}/run

Lance un agent sur un fichier ou contexte

GET

/v1/agents/bus

SSE — flux d'événements du Cognitive Bus

Lancer l'agent Sécurité

bash

curl https://api.sancti.app/v1/agents/security/run \
  -H "Authorization: Bearer sk-sancti-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "auth/jwt.ts",
    "mode": "scan"
  }'

Streaming

Activez le streaming avec stream: true — réponses en temps réel via SSE.

Streaming avec le SDK TypeScript

typescript

import { SanctiClient } from '@sancti/sdk';

const sancti = new SanctiClient({ apiKey: process.env.SANCTI_API_KEY });

const stream = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Écris une fonction de tri en Rust' }],
  stream: true,
});

for await (const chunk of stream) {
  const delta = chunk.choices[0]?.delta?.content || '';
  process.stdout.write(delta);
}

Erreurs

L'API retourne des erreurs au format standard JSON.

400bad_requestParamètre invalide ou manquant

401unauthorizedClé API manquante ou invalide

404model_not_foundLe modèle demandé n'existe pas

429rate_limit_exceededTrop de requêtes — réessayez après le header Retry-After

500internal_errorErreur serveur — contactez le support

503model_unavailableModèle local indisponible (Ollama non démarré ?)

SDK TypeScript

SDK officiel — compatible Node.js et navigateur.

Installation

bash

npm install @sancti/sdk
# ou
pnpm add @sancti/sdk

Usage complet

typescript

import { SanctiClient } from '@sancti/sdk';

const sancti = new SanctiClient({
  apiKey: process.env.SANCTI_API_KEY,
  baseURL: 'https://api.sancti.app/v1', // ou localhost:3001/v1
});

// Chat simple
const res = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Hello' }],
});

// Avec mémoire persistante
const res2 = await sancti.chat.completions.create({
  model: 'sancti-1',
  messages: [{ role: 'user', content: 'Tu te souviens de moi ?' }],
  memory: true,
  userId: 'user-123',
});

// Lister les modèles
const models = await sancti.models.list();

Prêt à intégrer Sancti ?

Essayez l'API dans le playground ou téléchargez le SDK.

Essayer le Playground SDK sur GitHub