Mastra ist ein TypeScript-Framework für KI-Agenten und Workflows. Neben den eingebauten Providern kann das model eines Agenten jeder OpenAI-kompatible Endpoint sein, angegeben als Objekt mit id und url. BroadNet Inference stellt unter https://inference.broadnet.ai/v1 standardmäßige Chat Completions bereit und funktioniert daher auf diesem Weg – mit einem Haken bei der Modell-ID. BroadRouter ist die Website von BroadNet selbst; die Anleitung folgt der Models-Dokumentation von Mastra und @mastra/core 1.83.0.
Installation
npm install @mastra/core zod
export BROADNET_API_KEY='your-broadnet-key'
Einen Agenten verbinden
import { Agent } from "@mastra/core/agent";
const broadnet = (model: string) => ({
id: `broadnet/${model}`, // Mastra strips the first segment
url: "https://inference.broadnet.ai/v1",
apiKey: process.env.BROADNET_API_KEY,
});
export const assistant = new Agent({
id: "assistant",
name: "Assistant",
instructions: "You are a concise assistant.",
model: broadnet("broadnet/glm-5.3"), // sends broadnet/glm-5.3
});
const res = await assistant.generate("Give me three names for a Go linting tool.");
console.log(res.text);
Warum das doppelte Präfix?
Laut Mastra-Dokumentation sendet eine id der Form provider/model nur den nackten Modellnamen an die Gegenstelle, während gateway/provider/model den Provider im Namen behält. Die IDs von BroadNet enthalten einen Schrägstrich und brauchen daher die längere Form. In unserem Test:
Mastra-id |
Bei BroadNet angekommene Modell-ID |
|---|---|
broadnet/glm-5.3 |
glm-5.3 (falsch) |
broadnet/broadnet/glm-5.3 |
broadnet/glm-5.3 (richtig) |
Die Hilfsfunktion oben ergänzt das zusätzliche Segment für Sie.
Tools
import { createTool } from "@mastra/core/tools";
import { z } from "zod";
const weather = createTool({
id: "get_weather",
description: "Get the weather for a city",
inputSchema: z.object({ city: z.string() }),
execute: async (input) => ({ city: input.city, tempC: 21 }),
});
const agent = new Agent({
id: "weather",
name: "Weather",
instructions: "Use the weather tool to answer.",
tools: { weather },
model: broadnet("broadnet/glm-5.3"),
});
Für Agenten mit Tools nehmen Sie broadnet/glm-5.3 oder broadnet/qwen3.8-27b. Die BroadNet-Dokumentation nennt Tools und strukturierte Ausgabe nur für diese beiden Modelle.
Streaming
const stream = await assistant.stream("Explain vector search in two sentences.");
for await (const chunk of stream.textStream) process.stdout.write(chunk);
Wichtige Einstellungen
urlist die Basis-URL und endet auf/v1. Mastra hängt/chat/completionsan.- Kein
api: "responses"ergänzen. Laut Mastra-Dokumentation schaltet das auf/v1/responsesum. BroadNet nennt die Responses API nicht. - Ausgabelimit. DeepSeek V4.1 Flash, GLM 5.3 und Qwen3.8 27B denken vor der Antwort nach, und das Reasoning zählt zum Ausgabelimit. Wenn Sie die Ausgabe-Tokens begrenzen, lassen Sie 2.000 oder mehr.
Welches Modell passt?
| Agent | Modell |
|---|---|
| Tools, strukturierte Ausgabe, Workflows | broadnet/glm-5.3 |
| Tools plus Bildeingabe oder arabischer Text | broadnet/qwen3.8-27b |
| Reine Textschritte in einem Plan mit Pauschalpreis | broadnet/deepseek-v4.1-flash |
Preise aller Modelle. Für das Vercel AI SDK ohne Mastra siehe den Leitfaden zum AI SDK.
So haben wir das getestet
Am 15. November 2026 haben wir @mastra/core 1.83.0 mit Node 24 installiert und generate, stream sowie einen Agenten mit Tool gegen einen lokalen Mock-Server laufen lassen, der das Chat-Completions-Format von BroadNet spricht und Tool-Calls zurückgibt. Die protokollierten Anfragen haben wir gelesen: Jeder Aufruf ging an /v1/chat/completions, mit einem Bearer-Schlüssel aus apiKey. So haben wir die Präfix-Regel aus der Tabelle oben gefunden. Wir hatten keinen BroadNet-Schlüssel und haben daher keine echte Modellausgabe getestet.
Fehlerbehebung
- 404 oder Modell nicht gefunden. Die Modell-ID hat vermutlich ihr Präfix verloren. Schreiben Sie die
idalsbroadnet/broadnet/glm-5.3. Prüfen Sie dann, oburlauf/v1endet. Kostenpflichtige Modelle brauchen eine Aufladung; das Guthaben von $5 deckt nurbroadnet/gemma-4-26b-a4bund die zwei Transcribe-Modelle ab. - 401.
BROADNET_API_KEYist im Prozess nicht gesetzt, oder der Schlüssel ist falsch oder sein Kontingent aufgebraucht. - Leere Antworten. Das Reasoning hat das Ausgabebudget verbraucht. Warum Antworten leer zurückkommen.
- 429 in Workflows mit parallelen Schritten. Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig laufende; eine Plan-Session verarbeitet eine nach der anderen. Siehe Fehlercodes und Retries.
