> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# ![Mastra logo](https://mastra.ai/brand/logo.svg)Mastra

La Gateway est un proxy d’API compatible OpenAI qui intègre la [mémoire observationnelle](https://gateway.mastra.ai/docs/features#observational-memory). Dirigez n’importe quel client HTTP, SDK ou framework vers la passerelle, et chaque conversation est mémorisée automatiquement sans code de gestion de la mémoire.

Pour en savoir plus, consultez la [documentation Gateway](https://gateway.mastra.ai/docs).

## Obtenir une clé API

Accédez à [gateway.mastra.ai](https://gateway.mastra.ai) et créez un compte Mastra. Lors de l’intégration, vous recevrez votre clé API personnelle pour authentifier vos requêtes.

## Utilisation

Définissez votre clé API comme variable d’environnement :

```bash
MASTRA_GATEWAY_API_KEY=your-gateway-key
```

Définissez l’ID de votre modèle de passerelle :

```typescript
import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "mastra/openai/gpt-5-mini"
});
```

Utilisez le même préfixe pour les modèles d’embedding qui doivent passer par la passerelle :

```typescript
import { ModelRouterEmbeddingModel } from "@mastra/core/llm";

const embedder = new ModelRouterEmbeddingModel("mastra/openai/text-embedding-3-small");
```

Transmettez `memory.thread` et `memory.resource` lorsque vous générez ou streamez des réponses pour activer la mémoire observationnelle :

```typescript
import { weatherAgent } from "./agents/weather-agent";

const memory = {
  thread: "assistant-thread-1",
  resource: "user-42",
};

const result = await weatherAgent.stream("My name is Alex and I prefer concise answers.", {
  memory,
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}
```

## Configuration

```bash
# Use gateway API key
MASTRA_GATEWAY_API_KEY=your-gateway-key
```

## En savoir plus

- [Features](https://gateway.mastra.ai/docs/features)
- [Modèles](https://gateway.mastra.ai/docs/models)
- [Limits](https://gateway.mastra.ai/docs/limits)
- [API Reference](https://gateway.mastra.ai/docs/api/overview)
- [Exemples](https://gateway.mastra.ai/docs/examples/)