Mastra
MarkdownFramework d’agents · OpenAI Chat, OpenAI Responses
Guide complet
| Format | Où configurer |
|---|---|
| OpenAI Chat, OpenAI Responses | Dans 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 stocker 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 ~/.bashrcsetx AILOOT_API_KEY "sk-..." # Puis redémarrez le terminalExemple 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 : pourquoi.
Documentation de l’application : https://mastra.ai/models