# 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 →](https://www.azothos.ai/auth/signup)

### 1. 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_…`.

### 2. 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
```

### 3. 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'));
```

### 4. 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"))
```

### 5. 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.

### 6. 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](https://www.azothos.ai/fr/docs/rules#exhaustion)).
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](https://www.azothos.ai/fr/docs/admin#governance-mode)). `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

- [Déclarer qui répond de chaque usage](https://www.azothos.ai/fr/docs/mandates)
- [Écrire les règles que la passerelle applique](https://www.azothos.ai/fr/docs/rules)
- [Lire le journal et les reçus](https://www.azothos.ai/fr/docs/proof)
- [Utiliser le SDK et l’API REST](https://www.azothos.ai/fr/docs/sdk)
