Premiers pas
Démarrage rapide
Envoyez votre premier appel par la passerelle Azoth, gardez son reçu et retrouvez sa décision scellée — en cinq minutes environ, sans changer vos prompts.
Il vous faut un espace de travail Azoth et une clé fournisseur enregistrée dans Réglages › Fournisseurs et modèles. Les exemples du SDK demandent Node.js 18 ou plus récent.
Dans Réglages › Accès, créez une clé API et copiez-la dans AZOTH_API_KEY : elle n’est affichée qu’une fois. Les espaces gratuits reçoivent des clés az_test_…, les offres payantes des clés az_live_….
La passerelle parle le format de chat d’OpenAI sur /api/v1/chat/completions. -D - affiche les en-têtes de la réponse, où voyage le reçu.
curl -sS -D - https://www.azothos.ai/api/v1/chat/completions \
-H "Authorization: Bearer $AZOTH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{ "role": "user", "content": "Say hello in one word." }]
}'
# HTTP/2 200
# x-azoth-receipt: eyJhbGciOiJFZERTQSIs…
# x-azoth-provider: openai
# x-azoth-model: gpt-4o-mini
# x-azoth-cost-usd: 0.00000330Changez l’URL de base et la clé — rien d’autre dans votre code. azothGatewayHeaders, de @azothos/sdk, ajoute les en-têtes Azoth facultatifs et refuse une valeur que la passerelle refuserait. .withResponse() donne aussi les en-têtes de la réponse, où voyage le reçu.
import OpenAI from 'openai';
import { azothGatewayHeaders } from '@azothos/sdk';
const openai = new OpenAI({
baseURL: 'https://www.azothos.ai/api/v1',
apiKey: process.env.AZOTH_API_KEY,
defaultHeaders: azothGatewayHeaders({ usecaseId: process.env.AZOTH_USECASE_ID }),
});
const { data, response } = await openai.chat.completions
.create({
model: 'gpt-4o-mini',
messages: [{ role: 'user', content: 'Say hello in one word.' }],
})
.withResponse();
console.log(data.choices[0].message.content);
console.log(response.headers.get('x-azoth-receipt'));Le paquet openai s’utilise de la même façon : changez base_url et la clé. with_raw_response garde les en-têtes de la réponse, où voyage le reçu.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://www.azothos.ai/api/v1",
api_key=os.environ["AZOTH_API_KEY"],
)
raw = client.chat.completions.with_raw_response.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Say hello in one word."}],
)
print(raw.parse().choices[0].message.content)
print(raw.headers.get("x-azoth-receipt"))Chaque réponse qui n’est pas diffusée en flux, servie ou bloquée, porte un reçu signé dans X-Azoth-Receipt — et dans azoth.receipt dans le corps JSON d’une réponse servie. Il désigne la décision sans aucun contenu : conservez-le avec vos dossiers. Une réponse diffusée en flux porte X-Azoth-Trace-Id à la place : sa décision est scellée à la fin du flux.
Dans Preuves › Décisions, l’appel apparaît avec son issue, ses règles et son droit. Vérifier moi-même ouvre le vérificateur hors ligne : collez le reçu, choisissez le dossier.
Fonctionnement
Un appel par la passerelle franchit ces étapes, dans cet ordre :
- La clé et le corps sont vérifiés. Un système exposé au public reçoit d’abord son palier d’épuisement des coûts (systèmes publics).
- L’appel est rattaché à son mandat : l’en-tête
X-Azoth-Usecase, sinon l’agent, le connecteur ou la clé auquel il est lié, sinon le mandat par défaut de l’espace de travail. - Les contrôles s’exécutent : l’arrêt d’urgence, l’état du mandat, les budgets, la souveraineté, les règles, le droit applicable, l’approbation humaine.
- Le modèle répond, chez le fournisseur que les règles autorisent. Le routage et le cache sont des enrichissements, à l’intérieur de ces règles.
- La décision est scellée dans le journal chaîné par empreintes de l’espace de travail — refus compris — et la réponse part avec son reçu.
Profils de gouvernance
La rigueur avec laquelle est traité un appel sans mandat approuvé suit le mode de gouvernance : le plus strict de celui du déploiement (GOVERNANCE_PROFILE) et de celui que l’espace de travail a choisi dans Réglages › Organisation — un espace de travail peut le durcir, jamais l’assouplir (mode de gouvernance). observe, par défaut, scelle et sert ; govern alerte en plus ; enforce refuse. Un mandat arrêté, et un système classé comme pratique interdite, sont refusés dans tous les modes.