# Inicio rápido

Envía tu primera llamada a través de la pasarela de Azoth, conserva su recibo y encuentra su decisión sellada — en unos cinco minutos, sin cambiar tus prompts.

> Necesitas un espacio de trabajo de Azoth y una clave de proveedor guardada en **Ajustes › Proveedores y modelos**. Los ejemplos del SDK requieren Node.js 18 o posterior.

[Crear una cuenta gratuita →](https://www.azothos.ai/auth/signup)

### 1. Crea una clave API

En **Ajustes › Acceso**, crea una clave API y cópiala en `AZOTH_API_KEY`: solo se muestra una vez. Los espacios de trabajo gratuitos reciben claves `az_test_…`; los planes de pago, `az_live_…`.

### 2. Envía una llamada a través de la pasarela

La pasarela habla el formato de chat de OpenAI en `/api/v1/chat/completions`. `-D -` muestra las cabeceras de la respuesta, donde viaja el recibo.

```
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. O apunta tu cliente de OpenAI a Azoth

Cambia la URL base y la clave — nada más en tu código. `azothGatewayHeaders` de `@azothos/sdk` añade las cabeceras opcionales de Azoth y rechaza un valor que la pasarela rechazaría. `.withResponse()` también te da las cabeceras de la respuesta, donde viaja el recibo.

```
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. O desde Python

El paquete `openai` funciona igual: cambia `base_url` y la clave. `with_raw_response` conserva las cabeceras de la respuesta, donde viaja el recibo.

```
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. Conserva el recibo

Cada respuesta que no se transmite en streaming, servida o bloqueada, lleva un recibo firmado en `X-Azoth-Receipt` — y en `azoth.receipt` dentro de un cuerpo JSON servido. Identifica la decisión sin ningún contenido: guárdalo con tus registros. Una respuesta en streaming lleva `X-Azoth-Trace-Id` en su lugar: su decisión se sella cuando termina el streaming.

### 6. Encuentra la decisión

En **Pruebas › Decisiones**, la llamada aparece con su resultado, sus reglas y su derecho. **Verificarlo yo mismo** abre el verificador sin conexión: pega el recibo y elige el expediente.

## Cómo funciona

Una llamada a través de la pasarela pasa por estos pasos, en este orden:

1. Se comprueban la clave y el cuerpo. Un sistema expuesto al público recibe primero su nivel de protección contra el agotamiento de costes ([sistemas públicos](https://www.azothos.ai/es/docs/rules#exhaustion)).
2. La llamada se vincula a su mandato: la cabecera `X-Azoth-Usecase`; si no, el agente, el conector o la clave a la que está vinculada; si no, el mandato por defecto del espacio de trabajo.
3. Se ejecutan las reglas: la parada de emergencia, el estado del mandato, los presupuestos, la soberanía, las reglas de política, el derecho aplicable, la aprobación humana.
4. El modelo responde, en el proveedor que las reglas permiten. El enrutamiento y la caché son enriquecimientos, dentro de esas reglas.
5. La decisión se sella en el diario encadenado por hash del espacio de trabajo — rechazos incluidos — y la respuesta sale con su recibo.

## Perfiles de gobernanza

El rigor con que se trata una llamada sin mandato aprobado depende del modo de gobernanza: el más estricto entre el del despliegue (`GOVERNANCE_PROFILE`) y el que el espacio de trabajo eligió en **Ajustes › Organización** — un espacio de trabajo puede endurecerlo, nunca relajarlo ([modo de gobernanza](https://www.azothos.ai/es/docs/admin#governance-mode)). `observe` (Observar), el valor por defecto, sella y sirve; `govern` (Gobernar) además alerta; `enforce` (Aplicar) rechaza. Un mandato detenido, y un sistema clasificado como práctica prohibida, se rechazan en cualquier modo.

## Siguiente

- [Declara quién responde de cada uso](https://www.azothos.ai/es/docs/mandates)
- [Escribe las reglas que aplica la pasarela](https://www.azothos.ai/es/docs/rules)
- [Lee el diario y los recibos](https://www.azothos.ai/es/docs/proof)
- [Usa el SDK y la API REST](https://www.azothos.ai/es/docs/sdk)
