Source: https://ailoot.ai/docs/de-at/integrations/mastra/
Canonical: https://ailoot.ai/docs/de-at/integrations/mastra/
Language: de-at

[SDKs und Frameworks](https://ailoot.ai/docs/de-at/integrations/#sdk) 

# Mastra

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

Agentenframework · OpenAI Chat, OpenAI Responses

| Format | Wo konfigurieren |
| --- | --- |
| OpenAI Chat, OpenAI Responses | In Agent: model: { id: "\<Anbieter\>/\<Modell\>", url: "\<Basisadresse\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/de-at/integrations/mastra/#setup)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.

```js
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:

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

```powershell
setx AILOOT_API_KEY "sk-..."   # danach das Terminal neu starten
```

Beispielmodell: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Andere Modelle wählen Sie aus dem [Katalog](https://ailoot.ai/models/de-at/) — prüfen Sie, ob das erforderliche Format verfügbar ist.

## [](https://ailoot.ai/docs/de-at/integrations/mastra/#notes)Wissenswertes

In url steht die Basisadresse mit /v1, nicht der vollständige Pfad zu /chat/completions. Standardmäßig wird Chat Completions verwendet; api: "responses" schaltet auf Responses API um. Das id-Muster "Anbieter/Modell" sendet die reine Modell-id an das Gateway. Das Feld apiKey im Objekt model wird in der Dokumentation anhand eines Beispiels mit Headern gezeigt; zusammen mit url ist es nicht gesondert beschrieben.

## [](https://ailoot.ai/docs/de-at/integrations/mastra/#check)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](https://ailoot.ai/docs/de-at/errors/).
- 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](https://ailoot.ai/docs/de-at/billing/reserve/).

Dokumentation der Anwendung: [https://mastra.ai/models](https://mastra.ai/models)

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.[Support kontaktieren](mailto:support@ailoot.ai)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.