---
title: "Mastra : point de terminaison compatible OpenAI (model url)"
description: "Faites tourner des agents Mastra sur BroadNet Inference avec un objet model qui définit id, url et apiKey, y compris le préfixe broadnet/ doublé qu’exige l’ID."
url: https://broadrouter.com/fr/guides/mastra-openai-compatible/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/mastra-openai-compatible/) (mis à jour le 2026-11-16).

# Utiliser des agents Mastra avec BroadNet Inference

Mis à jour 2026-11-16

Dans un Agent Mastra, réglez model sur un objet avec url https://inference.broadnet.ai/v1, apiKey lu depuis BROADNET\_API\_KEY et id broadnet/broadnet/glm-5.3. Mastra prend la première partie de l’id pour un nom de fournisseur et la retire : le préfixe doublé envoie donc broadnet/glm-5.3 à BroadNet. Les URL personnalisées utilisent chat completions par défaut. Pour les outils, prenez GLM 5.3 ou Qwen3.8 27B.

Mastra est un framework TypeScript pour les agents et workflows d’IA. Outre ses fournisseurs intégrés, le `model` d’un agent peut être n’importe quel point de terminaison compatible OpenAI, donné sous forme d’objet avec `id` et `url`. BroadNet Inference sert des chat completions standard à `https://inference.broadnet.ai/v1` et fonctionne donc de cette façon, avec une subtilité dans l’ID du modèle. BroadRouter est le site de BroadNet ; ce guide suit la [documentation des modèles de Mastra](https://mastra.ai/models) et @mastra/core 1.83.0.

## Installation

```bash
npm install @mastra/core zod
export BROADNET_API_KEY='your-broadnet-key'
```

## Connecter un agent

```ts
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);
```

### Pourquoi doubler le préfixe

D’après la documentation de Mastra, un `id` écrit `provider/model` envoie un nom de modèle nu au serveur distant, tandis que `gateway/provider/model` garde le fournisseur dans le nom. Les ID de BroadNet contiennent une barre oblique : ils ont donc besoin de la forme longue. Lors de notre test :

| `id` Mastra | ID de modèle reçu par BroadNet |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3` (incorrect) |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3` (correct) |

La fonction utilitaire ci-dessus ajoute ce segment supplémentaire pour vous.

## Outils

```ts
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"),
});
```

Utilisez `broadnet/glm-5.3` ou `broadnet/qwen3.8-27b` pour les agents avec outils. La documentation de BroadNet indique les outils et la sortie structurée pour ces deux modèles uniquement.

## Streaming

```ts
const stream = await assistant.stream("Explain vector search in two sentences.");
for await (const chunk of stream.textStream) process.stdout.write(chunk);
```

## Les réglages qui comptent

-   **`url`** est l’URL de base, terminée par `/v1`. Mastra y ajoute `/chat/completions`.
-   **N’ajoutez pas `api: "responses"`.** D’après la documentation de Mastra, cela bascule vers `/v1/responses`. BroadNet ne liste pas l’API Responses.
-   **Limite de sortie.** DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B raisonnent avant de répondre, et ce raisonnement est décompté de la limite de sortie. Si vous plafonnez les tokens de sortie, laissez-en 2 000 ou plus.

## Quel modèle choisir ?

| Agent | Modèle |
| --- | --- |
| Outils, sortie structurée, workflows | `broadnet/glm-5.3` |
| Outils plus entrée image ou texte arabe | `broadnet/qwen3.8-27b` |
| Étapes texte seul sur un forfait à prix fixe | `broadnet/deepseek-v4.1-flash` |

[Les prix de chaque modèle](https://broadrouter.com/fr/pricing/). Pour le Vercel AI SDK sans Mastra, voir [le guide de l’AI SDK](https://broadrouter.com/fr/guides/vercel-ai-sdk-openai-compatible/).

## Comment nous l’avons testé

Le 15 novembre 2026, nous avons installé @mastra/core 1.83.0 avec Node 24 et exécuté `generate`, `stream` et un agent avec outil face à un serveur fictif local qui parle le format chat completions de BroadNet et renvoie des appels d’outils. Nous avons lu les requêtes journalisées. Chaque appel est arrivé sur `/v1/chat/completions` avec une clé Bearer issue de `apiKey`. C’est ainsi que nous avons trouvé la règle de préfixe du tableau ci-dessus. Faute de clé BroadNet, nous n’avons pas testé de vraie sortie de modèle.

## Dépannage

-   **404 ou modèle introuvable.** L’ID du modèle a probablement perdu son préfixe. Écrivez l’`id` sous la forme `broadnet/broadnet/glm-5.3`. Vérifiez ensuite que `url` se termine par `/v1`. Les modèles payants nécessitent une recharge ; le crédit de $5 ne couvre que `broadnet/gemma-4-26b-a4b` et les deux modèles Transcribe.
-   **401.** `BROADNET_API_KEY` n’est pas défini dans le processus, ou la clé est erronée ou a épuisé son allocation.
-   **Réponses vides.** Le raisonnement a consommé le budget de sortie. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429 dans des workflows à étapes parallèles.** Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours ; une session de forfait les traite une par une. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).

## Termes de ce guide

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[API Chat Completions](https://broadrouter.com/fr/glossary/chat-completions-api/)

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[max\_tokens](https://broadrouter.com/fr/glossary/max-tokens/)

max\_tokens est un paramètre des API LLM qui fixe le nombre maximal de tokens qu’un modèle peut générer dans une réponse. Quand la génération atteint la limite, elle s’arrête et la réponse est marquée comme coupée, par exemple avec finish\_reason égal à « length ».

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[Sortie structurée (structured output)](https://broadrouter.com/fr/glossary/structured-output/)

La sortie structurée est une fonction des API LLM qui contraint la réponse d’un modèle à un format défini par le développeur, en général un JSON Schema, pour que le code puisse l’analyser de façon fiable. Elle est plus stricte que le mode JSON, qui garantit un JSON valide mais pas une structure précise.

[Streaming](https://broadrouter.com/fr/glossary/streaming/)

Le streaming est une manière de renvoyer la réponse d’un modèle de langage par petits chunks pendant sa génération, plutôt qu’en un seul bloc à la fin. Les API compatibles OpenAI streament via des server-sent events quand la requête règle stream sur true.

## Questions fréquentes

### Pourquoi Mastra envoie-t-il glm-5.3 au lieu de broadnet/glm-5.3 ?

Mastra lit l’id du modèle comme fournisseur/modèle et n’envoie que la partie située après la première barre oblique. Avec l’id broadnet/glm-5.3, il a envoyé glm-5.3 lors de notre test, ce que BroadNet ne reconnaît pas. Écrivez l’id sous la forme broadnet/broadnet/glm-5.3.

### L’url de Mastra doit-elle être l’URL de base ou celle de chat completions ?

L’URL de base. D’après la documentation de Mastra, il faut indiquer l’URL de base du point de terminaison compatible OpenAI : utilisez donc https://inference.broadnet.ai/v1 sans /chat/completions.

### Mastra utilise-t-il l’API Responses avec une URL personnalisée ?

Pas par défaut. D’après la documentation de Mastra, les points de terminaison personnalisés utilisent chat completions, sauf si vous ajoutez api réglé sur responses. Ne l’ajoutez pas pour BroadNet, qui sert chat completions.

### Les outils Mastra fonctionnent-ils sur BroadNet ?

Oui, sur un modèle pour lequel BroadNet indique les outils, GLM 5.3 ou Qwen3.8 27B. Lors de notre test avec un serveur fictif, l’agent a envoyé le schéma de l’outil, exécuté l’outil et renvoyé le résultat.

## Guides associés

-   [Utiliser le Vercel AI SDK avec BroadNet Inference](https://broadrouter.com/fr/guides/vercel-ai-sdk-openai-compatible/)
-   [Utiliser le SDK Node.js d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-node-sdk/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Codes d’erreur de BroadNet Inference : quand réessayer ?](https://broadrouter.com/fr/guides/errors-and-retries/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

[Commencer](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-mastra-openai-compatible&utm_content=page-cta) ·

**Sources**

-   [Documentation de Mastra, Models (points de terminaison compatibles OpenAI personnalisés) (consulté le 2026-11-15)](https://mastra.ai/models)
-   [Mastra sur GitHub, version @mastra/core 1.83.0 du 2026-11-13 (consulté le 2026-11-15)](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [Référence de l’API de BroadNet Inference (consulté le 2026-11-15) (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-mastra-openai-compatible&utm_content=sources)
