---
title: "Endpoint tersuai serasi OpenAI dalam Mastra (model url)"
description: "Jalankan ejen Mastra pada BroadNet Inference dengan objek model yang menetapkan id, url dan apiKey, termasuk awalan broadnet/ berganda yang diperlukan ID model."
url: https://broadrouter.com/ms/guides/mastra-openai-compatible/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/mastra-openai-compatible/) (dikemas kini 2026-11-16).

# Guna ejen Mastra dengan BroadNet Inference

Dikemas kini 2026-11-16

Dalam Agent Mastra, tetapkan model kepada objek dengan url https://inference.broadnet.ai/v1, apiKey daripada BROADNET\_API\_KEY dan id broadnet/broadnet/glm-5.3. Mastra menganggap bahagian pertama id sebagai nama penyedia dan membuangnya, jadi awalan berganda menghantar broadnet/glm-5.3 kepada BroadNet. URL tersuai menggunakan chat completions secara lalai. Gunakan GLM 5.3 atau Qwen3.8 27B untuk alatan.

Mastra ialah rangka kerja TypeScript untuk ejen dan aliran kerja AI. Selain penyedia terbina dalamnya, `model` sesuatu ejen boleh menjadi mana-mana endpoint serasi OpenAI, diberikan sebagai objek dengan `id` dan `url`. BroadNet Inference menyediakan chat completions standard di `https://inference.broadnet.ai/v1`, jadi ia berfungsi dengan cara ini, dengan satu perangkap pada ID model. BroadRouter ialah laman web BroadNet sendiri; panduan ini mengikut [dokumentasi models Mastra](https://mastra.ai/models) dan @mastra/core 1.83.0.

## Pasang

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

## Sambungkan ejen

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

### Mengapa awalan berganda

Dokumentasi Mastra menyatakan `id` yang ditulis sebagai `provider/model` menghantar nama model sahaja ke pelayan jauh, manakala `gateway/provider/model` mengekalkan penyedia dalam nama. ID BroadNet mengandungi garis miring, jadi ia memerlukan bentuk yang lebih panjang. Dalam ujian kami:

| `id` Mastra | ID model yang diterima BroadNet |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3` (salah) |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3` (betul) |

Fungsi pembantu di atas menambah segmen tambahan itu untuk anda.

## Alatan

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

Gunakan `broadnet/glm-5.3` atau `broadnet/qwen3.8-27b` untuk ejen dengan alatan. Dokumentasi BroadNet menyenaraikan tools dan output berstruktur untuk dua model ini sahaja.

## Penstriman

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

## Tetapan yang penting

-   **`url`** ialah base URL, berakhir dengan `/v1`. Mastra menambah `/chat/completions`.
-   **Jangan tambah `api: "responses"`.** Dokumentasi Mastra menyatakan itu menukar panggilan ke `/v1/responses`. BroadNet tidak menyenaraikan Responses API.
-   **Had output.** DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B membuat penaakulan sebelum menjawab, dan penaakulan dikira dalam had output. Jika anda mengehadkan token output, berikan 2,000 atau lebih.

## Model mana yang patut dipilih

| Ejen | Model |
| --- | --- |
| Alatan, output berstruktur, aliran kerja | `broadnet/glm-5.3` |
| Alatan serta input imej atau teks bahasa Arab | `broadnet/qwen3.8-27b` |
| Langkah teks sahaja pada pelan harga tetap | `broadnet/deepseek-v4.1-flash` |

[Harga setiap model](https://broadrouter.com/ms/pricing/). Untuk Vercel AI SDK tanpa Mastra, lihat [panduan AI SDK](https://broadrouter.com/ms/guides/vercel-ai-sdk-openai-compatible/).

## Cara kami mengujinya

Pada 2026-11-15 kami memasang @mastra/core 1.83.0 dengan Node 24 dan menjalankan `generate`, `stream` dan ejen alatan terhadap pelayan olok-olok tempatan yang mengikut bentuk chat completions BroadNet dan memulangkan panggilan alatan. Kami membaca permintaan yang dilog. Setiap panggilan pergi ke `/v1/chat/completions` dengan kunci Bearer daripada `apiKey`. Begitulah kami menemui peraturan awalan dalam jadual di atas. Kami tiada kunci BroadNet, jadi kami tidak menguji output model sebenar.

## Penyelesaian masalah

-   **404 atau model not found.** ID model mungkin kehilangan awalannya. Tulis `id` sebagai `broadnet/broadnet/glm-5.3`. Kemudian semak bahawa `url` berakhir dengan `/v1`. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputi `broadnet/gemma-4-26b-a4b` dan dua model Transcribe.
-   **401.** `BROADNET_API_KEY` tidak ditetapkan dalam proses, atau kunci salah atau kehabisan elaun.
-   **Balasan kosong.** Penaakulan menghabiskan bajet output. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429 dalam aliran kerja dengan langkah selari.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak; sesi pelan menjalankan satu permintaan pada satu masa. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

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

max\_tokens ialah parameter API LLM yang menetapkan bilangan maksimum token yang boleh dijana oleh model dalam satu respons. Apabila had itu dicapai, penjanaan berhenti dan respons ditandakan sebagai terpotong, contohnya dengan finish\_reason ditetapkan kepada "length".

[Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/)

Output berstruktur ialah ciri API LLM yang mengehadkan balasan model kepada format yang ditetapkan oleh pembangun, biasanya JSON Schema, supaya kod boleh menghuraikannya dengan boleh dipercayai. Ia lebih ketat daripada JSON mode, yang menjamin JSON yang sah tetapi bukan bentuk tertentu.

[Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/)

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

[Base URL (URL asas)](https://broadrouter.com/ms/glossary/base-url/)

Base URL ialah alamat akar tetap sesuatu API, seperti https://api.example.com/v1, yang diletakkan oleh klien di hadapan setiap laluan endpoint, seperti /chat/completions. Dalam SDK serasi OpenAI, menukar base URL, bersama kunci API dan ID model, menghalakan kod yang sama kepada penyedia lain.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

## Soalan lazim

### Mengapakah Mastra menghantar glm-5.3 dan bukan broadnet/glm-5.3?

Mastra membaca id model sebagai provider/model dan hanya menghantar bahagian selepas garis miring pertama. Dengan id broadnet/glm-5.3, ia menghantar glm-5.3 dalam ujian kami, yang tidak dikenali oleh BroadNet. Tulis id sebagai broadnet/broadnet/glm-5.3.

### Patutkah url Mastra ialah base URL atau URL chat completions?

Base URL. Dokumentasi Mastra menyuruh anda menggunakan base URL endpoint serasi OpenAI, jadi gunakan https://inference.broadnet.ai/v1 tanpa /chat/completions.

### Adakah Mastra menggunakan Responses API dengan URL tersuai?

Tidak secara lalai. Dokumentasi Mastra menyatakan endpoint tersuai menggunakan chat completions kecuali anda menambah api yang ditetapkan kepada responses. Jangan tambahnya untuk BroadNet, yang menyediakan chat completions.

### Adakah alatan Mastra berfungsi pada BroadNet?

Ya, pada model yang disenaraikan BroadNet dengan tools, iaitu GLM 5.3 atau Qwen3.8 27B. Dalam ujian olok-olok kami, ejen menghantar skema alatan, menjalankan alatan itu dan memulangkan hasilnya.

## Panduan berkaitan

-   [Cara guna Vercel AI SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/vercel-ai-sdk-openai-compatible/)
-   [Cara guna OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-node-sdk/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

-   [Dokumentasi Mastra, Models (endpoint tersuai serasi OpenAI) (disemak 2026-11-15)](https://mastra.ai/models)
-   [Mastra di GitHub, keluaran @mastra/core 1.83.0, 2026-11-13 (disemak 2026-11-15)](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [Rujukan API BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-mastra-openai-compatible&utm_content=sources)
