---
title: "Mastra и свой OpenAI-совместимый эндпоинт (model url)"
description: "Как запустить агентов Mastra на BroadNet Inference через объект model с id, url и apiKey и почему ID модели нужен двойной префикс broadnet/."
url: https://broadrouter.com/ru/guides/mastra-openai-compatible/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/mastra-openai-compatible/) (обновлён 2026-11-16).

# Агенты Mastra на BroadNet Inference

Обновлено 2026-11-16

В Agent из Mastra задайте model объектом: url https://inference.broadnet.ai/v1, apiKey из BROADNET\_API\_KEY и id broadnet/broadnet/glm-5.3. Mastra считает первую часть id именем провайдера и отрезает её, поэтому с двойным префиксом в BroadNet уходит broadnet/glm-5.3. Для пользовательских URL по умолчанию используются chat completions. Для инструментов берите GLM 5.3 или Qwen3.8 27B.

Mastra — TypeScript-фреймворк для ИИ-агентов и workflow. Помимо встроенных провайдеров, в `model` агента можно указать любой OpenAI-совместимый эндпоинт — объектом с `id` и `url`. BroadNet Inference отдаёт стандартные chat completions по адресу `https://inference.broadnet.ai/v1`, так что этот способ работает, но с одной особенностью в ID модели. BroadRouter — собственный сайт BroadNet; руководство основано на [документации Mastra по моделям](https://mastra.ai/models) и @mastra/core 1.83.0.

## Установка

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

## Подключение агента

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

Комментарии в коде поясняют: Mastra отрезает первый сегмент `id`, поэтому хелпер добавляет лишний, и в BroadNet уходит полный ID модели с префиксом `broadnet/`.

### Зачем двойной префикс

Документация Mastra говорит, что `id` вида `provider/model` отправляет на удалённый сервер голое имя модели, а `gateway/provider/model` сохраняет провайдера в имени. В ID моделей BroadNet есть косая черта, поэтому нужна длинная форма. В нашем тесте:

| `id` в Mastra | ID модели, который получил BroadNet |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3` (неверно) |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3` (верно) |

Хелпер выше добавляет лишний сегмент за вас.

## Инструменты

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

Для агентов с инструментами используйте `broadnet/glm-5.3` или `broadnet/qwen3.8-27b`. Документация BroadNet указывает инструменты и структурированный вывод только для этих двух моделей.

## Стриминг

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

## Важные настройки

-   **`url`** — базовый URL, заканчивается на `/v1`. Mastra добавляет `/chat/completions` сама.
-   **Не добавляйте `api: "responses"`.** По документации Mastra это переключает запросы на `/v1/responses`. BroadNet не указывает Responses API.
-   **Лимит вывода.** DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B рассуждают перед ответом, и рассуждения учитываются в лимите вывода. Если вы ограничиваете число токенов вывода, оставьте 2 000 или больше.

## Какую модель выбрать

| Агент | Модель |
| --- | --- |
| Инструменты, структурированный вывод, workflow | `broadnet/glm-5.3` |
| Инструменты плюс изображения на входе или арабский текст | `broadnet/qwen3.8-27b` |
| Текстовые шаги на тарифе с фиксированной ценой | `broadnet/deepseek-v4.1-flash` |

[Цены на все модели](https://broadrouter.com/ru/pricing/). Если нужен Vercel AI SDK без Mastra, см. [руководство по AI SDK](https://broadrouter.com/ru/guides/vercel-ai-sdk-openai-compatible/).

## Как мы это проверяли

15 ноября 2026 г. мы установили @mastra/core 1.83.0 на Node 24 и запустили `generate`, `stream` и агента с инструментом против локального mock-сервера, который отвечает в формате chat completions BroadNet и возвращает вызовы инструментов. Затем мы прочитали журнал запросов. Все вызовы ушли на `/v1/chat/completions` с Bearer-ключом из `apiKey`. Так мы и обнаружили правило префикса из таблицы выше. Ключа BroadNet у нас не было, поэтому реальные ответы модели мы не проверяли.

## Решение проблем

-   **404 или модель не найдена.** Скорее всего, ID модели потерял префикс. Запишите `id` как `broadnet/broadnet/glm-5.3`. Затем проверьте, что `url` заканчивается на `/v1`. Для платных моделей нужно пополнить баланс; стартовый грант $5 покрывает только `broadnet/gemma-4-26b-a4b` и две модели Transcribe.
-   **401.** `BROADNET_API_KEY` не задан в процессе, либо ключ неверный или исчерпал лимит.
-   **Пустые ответы.** Рассуждения израсходовали бюджет вывода. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **429 в workflow с параллельными шагами.** Ключ с оплатой по факту допускает 30 запросов в минуту и не больше 4 одновременно; сессия тарифа обрабатывает один запрос за раз. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).

## Термины в этом руководстве

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

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

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

[ИИ-агент (AI agent)](https://broadrouter.com/ru/glossary/agent/)

ИИ-агент — это система, в которой языковая модель сама направляет свои шаги к цели: решает, какие инструменты вызвать, читает результаты и повторяет, пока не выдаст итоговый ответ или не упрётся в лимит. Фиксированный сценарий, который вызывает модель в заранее заданных местах, обычно называют не агентом, а workflow.

## Вопросы и ответы

### Почему Mastra отправляет glm-5.3 вместо broadnet/glm-5.3?

Mastra читает id модели как provider/model и отправляет только часть после первой косой черты. С id broadnet/glm-5.3 в нашем тесте ушло glm-5.3, а такую модель BroadNet не распознает. Пишите id как broadnet/broadnet/glm-5.3.

### Что указывать в url Mastra: базовый URL или адрес chat completions?

Базовый URL. Документация Mastra говорит указывать базовый URL OpenAI-совместимого эндпоинта, так что используйте https://inference.broadnet.ai/v1 без /chat/completions.

### Использует ли Mastra Responses API с пользовательским URL?

По умолчанию нет. Документация Mastra говорит, что пользовательские эндпоинты работают через chat completions, пока вы не добавите api со значением responses. Для BroadNet его не добавляйте: BroadNet обслуживает chat completions.

### Работают ли инструменты Mastra с BroadNet?

Да, на моделях, для которых BroadNet указывает инструменты: GLM 5.3 или Qwen3.8 27B. В нашем тесте с mock-сервером агент отправил схему инструмента, выполнил инструмент и вернул результат.

## Похожие руководства

-   [Vercel AI SDK и BroadNet Inference: OpenAI-совместимый провайдер](https://broadrouter.com/ru/guides/vercel-ai-sdk-openai-compatible/)
-   [OpenAI Node.js SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-node-sdk/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Все инструменты, которые работают с BroadNet Inference (на английском)](https://broadrouter.com/integrations/): SDK, агенты для программирования, чат-интерфейсы и инструменты автоматизации с точными настройками для каждого

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-mastra-openai-compatible&utm_content=page-cta) ·

**Источники**

-   [Документация Mastra, Models (пользовательские OpenAI-совместимые эндпоинты) (дата обращения 2026-11-15)](https://mastra.ai/models)
-   [Mastra на GitHub, релиз @mastra/core 1.83.0 от 2026-11-13 (дата обращения 2026-11-15)](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [Справочник API BroadNet Inference (дата обращения 2026-11-15) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-mastra-openai-compatible&utm_content=sources)
