Source: https://ailoot.ai/docs/fr-ch/integrations/mastra/
Canonical: https://ailoot.ai/docs/fr-ch/integrations/mastra/
Language: fr-ch

[SDK et frameworks](https://ailoot.ai/docs/fr-ch/integrations/#sdk) 

# Mastra

[Markdown](https://ailoot.ai/docs/fr-ch/integrations/mastra/index.md)

Framework d’agents · OpenAI Chat, OpenAI Responses

| Format | Où configurer |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Dans Agent : model : { id: "\<provider\>/\<model\>", url: "\<base-url\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/fr-ch/integrations/mastra/#setup)Configuration

Copiez la configuration et remplacez `sk-...` par votre clé de l’espace client Ailoot. Il est préférable de conserver la clé dans la variable d’environnement `AILOOT_API_KEY`, si l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, POST /v1/responses, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Réponds en russe",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // uniquement pour les modèles prenant en charge la méthode responses
  }
});
```

Cette configuration lit la clé dans la variable `AILOOT_API_KEY`. Définissez-la avant de lancer l’application :

```bash
export AILOOT_API_KEY="sk-..."   # Ajoutez à ~/.zshrc ou ~/.bashrc
```

```powershell
setx AILOOT_API_KEY "sk-..."   # Puis redémarrez le terminal
```

Exemple de modèle : `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Choisissez tout autre modèle dans le [catalogue](https://ailoot.ai/models/fr-ch/) — vérifiez qu’il prend en charge le format requis.

## [](https://ailoot.ai/docs/fr-ch/integrations/mastra/#notes)À savoir

url contient l’adresse de base avec /v1, et non le chemin complet /chat/completions. Chat Completions est utilisé par défaut ; api : "responses" active Responses API. La forme d’id "провайдер/модель" envoie à la passerelle l’id du modèle seul. Dans la documentation, apiKey dans l’objet model est présenté dans un exemple avec des en-têtes, sans description séparée de son utilisation avec url.

## [](https://ailoot.ai/docs/fr-ch/integrations/mastra/#check)Vérification

- Pour le format OpenAI, l’adresse est `https://api.ailoot.ai/v1` (ou le chemin complet si l’application demande une adresse complète).
- Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page [Erreurs et limites](https://ailoot.ai/docs/fr-ch/errors/).
- Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de `/v1`.
- Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : [explication](https://ailoot.ai/docs/fr-ch/billing/reserve/).

Documentation de l’application : [https://mastra.ai/models](https://mastra.ai/models)

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à l’analyser.[Contacter l’assistance](mailto:support@ailoot.ai)

## Ailoot · L’entreprise et son portefeuille de projets





Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.





L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.





Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.