---
title: "Hướng dẫn nhanh BroadNet Inference: Python và cURL | BroadRouter"
description: "Gửi request chat và chuyển giọng nói thành văn bản đầu tiên đến BroadNet Inference bằng Python hoặc cURL, rồi làm theo checklist chuyển đổi cho model của bạn."
url: https://broadrouter.com/vi/developers/
lang: vi
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# Nhà phát triển

Cập nhật 2026-11-15

BroadNet Inference dùng cấu trúc request của OpenAI tại `https://inference.broadnet.ai/v1`. Tạo key trong console, lưu nó trong biến môi trường, rồi gửi request đến `/chat/completions` hoặc `/audio/transcriptions` với đúng ID model. Trước khi chuyển traffic production, hãy kiểm tra tham số, streaming, công cụ, giới hạn và lỗi của model đó.

-   Hướng dẫn nhanh: chat
-   Hướng dẫn nhanh: chuyển giọng nói thành văn bản
-   ID model
-   Checklist chuyển đổi
-   Lỗi và thử lại
-   Tài liệu và hướng dẫn

## Làm sao gửi request chat đầu tiên?

1.  Đăng nhập [inference.broadnet.ai (tiếng Anh)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=quickstart-account) và tạo một inference key. Key chỉ hiển thị một lần; console chỉ lưu giá trị hash của nó.
2.  Cài OpenAI SDK và đặt key trong shell. Giữ key trên server, không bao giờ để trong code chạy trên trình duyệt.
3.  Gửi request. Đọc câu trả lời từ `choices[0].message.content`.

setup

```
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

first\_request.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

request.sh

```
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","messages":[{"role":"user","content":"Reply with one short sentence."}]}'
```

Ví dụ dùng BroadNet Gemma 4 VL 26B, model mà tín dụng ban đầu US$5 chi trả được. DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B cần nạp tiền trước. Hãy giữ header phản hồi `X-Request-ID` để gửi cho bộ phận hỗ trợ.

How a request reaches a model

1.  01**Your app**Key kept in an environment variable
    
2.  02**OpenAI SDK**Two settings change
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**OpenAI-compatible API`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**The model you name**Set in every request
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`your choice
    
5.  05**Response**From that model
    

You choose the model in each request. There is no automatic routing: the request runs on the model ID you sent.

Your app calls the OpenAI SDK with BroadNet’s base URL and your key. The request goes to BroadNet Inference with the model ID you wrote, and that model answers. Nothing picks or switches the model for you.

### Streaming

Đặt `stream=true` và đọc Server-Sent Events cho đến `data: [DONE]`. Với `stream_options.include_usage`, thông tin sử dụng token đến trong chunk cuối. Nếu stream kết thúc trước `[DONE]`, hãy coi câu trả lời là chưa đầy đủ. BroadNet đề nghị kiểm tra streaming cho từng model trước khi dựa vào nó trong production.

stream.sh

```
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## Làm sao chuyển âm thanh thành văn bản?

Gửi WAV hoặc MP3, tối đa 26.214.400 byte mỗi file, đến `/audio/transcriptions`. Luôn đặt `language`: nếu thiếu, tiếng Ả Rập có thể trả về bằng chữ Latin. Dùng `language=ar` cho tiếng Ả Rập. Chuyển đổi file `.ogg` hoặc `.m4a` trước: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

Phản hồi là JSON, bản chép lời nằm trong `text`. [Model tiếng Ả Rập hay đa ngôn ngữ, và chi phí âm thanh](https://broadrouter.com/vi/arabic-transcription/).

## Có thể dùng những ID model nào?

Truyền đúng ID vào `model`. Đừng dựa vào `/v1/models` để tìm model chat; hãy dùng danh sách này hoặc [tài liệu tham chiếu (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=models-docs#models).

| Model | ID | Endpoint | Đầu vào | Có trong tài liệu | Quyền truy cập |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/vi/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | Văn bản + Hình ảnh | Suy luận | Cần nạp tiền |
| [GLM 5.3](https://broadrouter.com/vi/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | Văn bản | Công cụ, Đầu ra có cấu trúc, Suy luận | Cần nạp tiền |
| [Qwen3.8 27B](https://broadrouter.com/vi/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | Văn bản + Hình ảnh | Công cụ, Đầu ra có cấu trúc, Suy luận | Cần nạp tiền |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/vi/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | Văn bản + Hình ảnh | — | Tín dụng ban đầu |
| [BroadNet Transcribe Arabic](https://broadrouter.com/vi/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | Âm thanh tiếng Ả Rập | — | Tín dụng ban đầu |
| [BroadNet Transcribe](https://broadrouter.com/vi/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | Âm thanh, 14 ngôn ngữ | — | Tín dụng ban đầu |

“Có trong tài liệu” liệt kê công cụ, đầu ra có cấu trúc và suy luận mà tài liệu tham chiếu của BroadNet ghi cho từng model (kiểm tra ngày 2026-11-15). Dấu gạch ngang nghĩa là tài liệu không ghi, không có nghĩa là model không có.

## Chuyển từ một API tương thích OpenAI khác: checklist

Cấu trúc request quen thuộc, nhưng các model khác nhau. Hãy kiểm tra từng mục cho model bạn chọn và thử nghiệm trước khi chuyển traffic.

1.  **Endpoint.** Đặt base URL là `https://inference.broadnet.ai/v1`.
2.  **Key.** Dùng inference key của BroadNet lấy từ biến môi trường. Key của gói và key trả theo mức dùng là hai loại riêng.
3.  **ID model.** Dùng đúng ID, ví dụ `broadnet/gemma-4-26b-a4b`.
4.  **Tham số.** Kiểm tra mọi tham số bạn gửi đều có trong tài liệu của model đó. Bỏ những tham số không được liệt kê.
5.  **Streaming.** Xác nhận client đọc SSE đến `[DONE]` và xử lý được stream kết thúc sớm.
6.  **Công cụ và đầu ra có cấu trúc.** Tài liệu tham chiếu ghi các tính năng này cho GLM 5.3 và Qwen3.8 27B. Hãy thử nghiệm mọi model khác trước khi dựa vào chúng.
7.  **Suy luận.** Phần suy luận có thể dùng một phần ngân sách đầu ra. Hãy chừa khoảng trống trong `max_tokens`; xem [câu trả lời rỗng từ model suy luận](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
8.  **Giới hạn.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đồng thời. Một phiên của gói xử lý một request tại một thời điểm. Một key Gemma theo giờ cho phép một luồng, 120 request mỗi phút và 300.000 token mỗi phút.
9.  **Context.** Context gồm cả đầu vào và câu trả lời. Kiểm tra giới hạn của model trên [trang model](https://broadrouter.com/vi/models/) của nó.
10.  **Lỗi.** Ánh xạ các mã trạng thái dưới đây sang hành động thử lại hoặc sửa lỗi, và ghi log `X-Request-ID`.
11.  **Chi phí.** Ước tính bằng [công cụ tính giá](https://broadrouter.com/vi/pricing/). Với trả theo mức dùng, hình ảnh được tính là token đầu vào.

## Nên thử lại những lỗi nào?

| Trạng thái | Ý nghĩa | Hành động |
| --- | --- | --- |
| 400 / 422 | Request hoặc trường không hợp lệ | Sửa request; không thử lại nguyên trạng |
| 401 | Key thiếu, không hợp lệ hoặc hết hạn, hoặc đã dùng hết hạn mức | Kiểm tra key và tài khoản |
| 402 | `insufficient_balance` | Nạp tiền rồi thử lại |
| 413 | Request vượt giới hạn byte hoặc văn bản | Gửi ít hơn, ví dụ file âm thanh nhỏ hơn |
| 429 | Giới hạn tần suất, đồng thời, token mỗi phút hoặc chi tiêu | Tạm dừng có giới hạn số lần, rồi thử lại |
| 500–504 | Sự cố phía server | Thử lại với exponential backoff có giới hạn |

Tóm tắt từ [bảng lỗi trong tài liệu tham chiếu (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=errors-docs#errors), kiểm tra ngày 2026-11-15. [Code mẫu cho việc thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).

## Tài liệu đầy đủ và hướng dẫn ở đâu?

-   [**Tài liệu cho nhà phát triển (tiếng Anh)**Cấu trúc request, giới hạn, lỗi và feed giá. Nguồn chính thức.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=docs)
-   [**Tích hợp (tiếng Anh)**Cấu hình cho Aider, Cline, LangChain, n8n, LiteLLM và các công cụ tương thích OpenAI khác.](https://broadrouter.com/integrations/)
-   [**Hướng dẫn**SDK, streaming, thử lại, danh sách IP được phép và giọng nói tiếng Ả Rập.](https://broadrouter.com/vi/guides/)
-   [**Hướng dẫn Python SDK**Cài đặt, request đầu tiên và streaming với OpenAI Python SDK.](https://broadrouter.com/vi/guides/openai-python-sdk/)
-   [**Hướng dẫn Node SDK**Tương tự bằng JavaScript và TypeScript, kèm ID request.](https://broadrouter.com/vi/guides/openai-node-sdk/)
-   [**Hướng dẫn nhanh cURL**Mọi request từ shell.](https://broadrouter.com/vi/guides/curl-quickstart/)
-   [**Key và danh sách IP được phép**Khóa key vào server của bạn.](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/)
-   [**Trình tạo request API (tiếng Anh)**Tạo request ngay trên trình duyệt và sao chép.](https://broadrouter.com/tools/api-request-builder/)

Cần endpoint riêng hoặc model không có trong danh sách? [Liên hệ BroadNet](https://broadrouter.com/vi/contact/#private).

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu cho nhà phát triển BroadNet Inference (kiểm tra ngày 2026-11-15) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=sources)
-   [Bảng giá BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=sources)
-   [pricing.json, bảng giá công bố (tiếng Anh)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-developers&utm_content=sources)
