Démarrer gratuitement →

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.

Créer un compte gratuit →

Créer une clé API

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_….

Envoyer un appel par la passerelle

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.00000330
Ou pointer votre client OpenAI vers Azoth

Changez 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'));
Ou depuis Python

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"))
Garder le reçu

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.

Retrouver la décision

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 :

  1. 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).
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Ensuite