Doku
SDKs und Frameworks

Mastra

Markdown

Agentenframework · OpenAI Chat, OpenAI Responses

Vollständiger Leitfaden
FormatWo konfigurieren
OpenAI Chat, OpenAI ResponsesIn Agent: model: { id: "<Anbieter>/<Modell>", url: "<Basisadresse>", apiKey, api?: "chat" | "responses" }

Konfiguration

Kopieren Sie die Konfiguration und ersetzen Sie sk-... durch Ihren Schlüssel aus dem Ailoot-Kundenbereich. Speichern Sie den Schlüssel am besten in der Umgebungsvariablen AILOOT_API_KEY, sofern die Anwendung dies unterstützt.

Rufen Sie vor dem Start GET /v1/models mit Ihrem Ailoot-Schlüssel ab. Wählen Sie eine genaue Modell-ID mit den Methoden POST /v1/chat/completions, POST /v1/responses und tragen Sie diese ID in die Konfiguration ein. Prüfen Sie bei Agenten auch die Werkzeugunterstützung und die für Ihre Clientversion benötigten Funktionen.

import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Antworte auf Russisch",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // nur für Modelle mit der Methode responses
  }
});

Diese Konfiguration liest den Schlüssel aus der Variablen AILOOT_API_KEY. Setzen Sie sie vor dem Start der Anwendung:

export AILOOT_API_KEY="sk-..."   # in ~/.zshrc oder ~/.bashrc einfügen

Beispielmodell: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Andere Modelle wählen Sie aus dem Katalog — prüfen Sie, ob das erforderliche Format verfügbar ist.

Wissenswertes

Prüfung

  • Für das OpenAI-Format lautet die Adresse https://api.ailoot.ai/v1 (oder der vollständige Pfad, wenn die Anwendung eine vollständige Adresse verlangt).
  • Stellen Sie eine kurze Frage. Bei einem Fehler prüfen Sie Code und Request ID und vergleichen Sie diese mit der Seite Fehler und Limits.
  • 404 direkt nach der Einrichtung bedeutet fast immer eine falsche Adresse: ein zusätzliches oder fehlendes /v1.
  • 402 — das Guthaben reicht für die Reservierung nicht aus. Agenten reservieren mehr als ein Chat: warum.

Dokumentation der Anwendung: https://mastra.ai/models

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.Support kontaktieren