docs
SDK et frameworks

Mastra

Markdown

Framework d’agents · OpenAI Chat, OpenAI Responses

Guide complet
FormatOù configurer
OpenAI Chat, OpenAI ResponsesDans Agent : model : { id: "<provider>/<model>", url: "<base-url>", apiKey, api?: "chat" | "responses" }

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.

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 :

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

Exemple de modèle : ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Choisissez tout autre modèle dans le catalogue — vérifiez qu’il prend en charge le format requis.

À savoir

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.
  • 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.

Documentation de l’application : https://mastra.ai/models

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à l’analyser.Contacter l’assistance