---
title: "Cấu hình goose với custom provider tương thích OpenAI"
description: "Kết nối AI agent goose với BroadNet Inference dưới dạng custom provider OpenAI Compatible, từ goose Desktop, lệnh goose configure hoặc một file JSON."
url: https://broadrouter.com/vi/guides/goose-custom-provider/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/goose-custom-provider/) (cập nhật ngày 2026-11-16).

# Thêm BroadNet Inference vào goose làm custom provider

Cập nhật 2026-11-16

Trong goose, thêm một custom provider loại OpenAI Compatible, API URL là https://inference.broadnet.ai/v1/chat/completions, key BroadNet của bạn và các model khả dụng như broadnet/glm-5.3. Dùng nút Add Custom Provider trong goose Desktop, lệnh goose configure trong terminal, hoặc một file JSON trong ~/.config/goose/custom\_providers/. goose dựa vào gọi tool, nên hãy bắt đầu với GLM 5.3 hoặc Qwen3.8 27B.

goose là một AI agent mã nguồn mở có ứng dụng desktop và CLI. Những dịch vụ không có sẵn được thêm vào dưới dạng **custom provider**, và goose hỗ trợ provider tương thích OpenAI. BroadNet Inference phục vụ chat completions chuẩn, nên kết nối được theo cách này. BroadRouter là trang web của chính BroadNet; các bước dưới đây làm theo [tài liệu provider của goose](https://goose-docs.ai/docs/getting-started/providers/) tính đến goose 1.59.

Tài liệu goose cảnh báo rằng nó “extensively uses tool calling” (Bản dịch: dùng gọi tool rất nhiều), và model không có gọi tool chỉ có thể chat khi tắt mọi extension. BroadNet ghi hỗ trợ gọi tool cho GLM 5.3 và Qwen3.8 27B, nên hãy dùng một trong hai model này cho việc của agent.

## Cách 1: goose Desktop

1.  Mở thanh bên, bấm **Settings**, rồi chọn tab **Models**.
    
2.  Bấm **Configure providers**, rồi **Add Custom Provider** ở cuối.
    
3.  Điền thông tin:
    
    | Trường | Giá trị |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | key BroadNet của bạn |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | bật |
    
4.  Bấm **Create Provider**, rồi chọn provider đó và một model.
    

## Cách 2: goose CLI

Chạy `goose configure`, chọn **Custom Providers**, rồi **Add A Custom Provider**, và trả lời các câu hỏi bằng cùng các giá trị: loại API là OpenAI Compatible, API URL như trên, xác thực **Yes** với một API key cố định, danh sách model phân tách bằng dấu phẩy, và bật streaming.

## Cách 3: file JSON

Tạo `~/.config/goose/custom_providers/broadnet.json` (trên Windows là `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Sau đó mở một phiên với provider này:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

Có thể đưa file này vào repository cho cả nhóm, vì key nằm trong biến môi trường.

## Kiểm tra

Bắt đầu bằng một câu hỏi đơn giản, như “what can you do?”. Có câu trả lời nghĩa là kết nối đã hoạt động. Sau đó yêu cầu một việc cần đến một extension đang bật. Nếu goose gọi tool thì gọi tool cũng hoạt động. Nếu nó chỉ trả lời bằng văn bản và không bao giờ gọi tool, hãy chuyển sang `broadnet/glm-5.3`.

## Giá trong goose

goose có thể ước tính chi phí nếu mỗi model trong file JSON có `input_token_cost` và `output_token_cost` tính bằng USD mỗi token. Lấy số liệu từ [trang giá](https://broadrouter.com/vi/pricing/) của BroadNet và chia giá mỗi triệu token cho 1.000.000. Nếu thiếu một trong hai trường, goose dùng giá trong danh mục riêng của nó, có thể không khớp với giá của BroadNet.

## Xử lý sự cố

-   **401.** Key sai, hết hạn hoặc hết hạn mức, hoặc `BROADNET_API_KEY` chưa được đặt trong shell khởi chạy goose.
-   **404.** Kiểm tra API URL. Nó phải là `https://inference.broadnet.ai/v1/chat/completions`. Kiểm tra model ID khớp chính xác với ID của BroadNet. Các model trả phí cần nạp tiền; $5 tín dụng ban đầu chỉ dùng được cho `broadnet/gemma-4-26b-a4b` và hai model Transcribe, và context 32.768 token của Gemma khá nhỏ cho việc của agent.
-   **Câu trả lời rỗng.** Trên DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B, suy luận được tính vào giới hạn đầu ra. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý cùng lúc. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Request phải chờ hoặc thất bại khi hai phiên goose dùng chung một key gói.** Một [phiên của gói](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/) chạy một request tại một thời điểm, nên hãy cho mỗi phiên goose một phiên riêng.

## Thuật ngữ trong hướng dẫn này

[Tool calling (gọi tool, function calling)](https://broadrouter.com/vi/glossary/tool-calling/)

Tool calling, còn gọi là function calling, là tính năng của API LLM trong đó model trả về một yêu cầu có cấu trúc để chạy một hàm do nhà phát triển định nghĩa, kèm đối số JSON. Ứng dụng chạy hàm rồi gửi kết quả lại; model không bao giờ tự chạy code.

[Token](https://broadrouter.com/vi/glossary/token/)

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Streaming (trả phản hồi dạng luồng)](https://broadrouter.com/vi/glossary/streaming/)

Streaming là cách trả phản hồi của model ngôn ngữ thành từng chunk nhỏ ngay trong lúc nó đang được sinh, thay vì một câu trả lời trọn vẹn ở cuối. Các API tương thích OpenAI stream qua server-sent events khi request đặt stream là true.

[AI agent (tác tử AI)](https://broadrouter.com/vi/glossary/agent/)

AI agent là hệ thống trong đó model ngôn ngữ tự điều khiển các bước để đạt mục tiêu: nó quyết định gọi tool nào, đọc kết quả và lặp lại cho tới khi đưa ra câu trả lời cuối cùng hoặc chạm giới hạn. Script cố định gọi model ở các điểm định sẵn thường gọi là workflow.

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

## Câu hỏi thường gặp

### API URL của goose nên kết thúc bằng /v1 hay /v1/chat/completions?

Ví dụ custom provider của chính goose dùng URL chat completions đầy đủ, nên hãy dùng https://inference.broadnet.ai/v1/chat/completions. Như vậy goose cũng luôn dùng chat completions, đúng thứ BroadNet phục vụ.

### Model BroadNet nào chạy tốt nhất với goose?

GLM 5.3 (broadnet/glm-5.3). Tài liệu goose nói nó dùng gọi tool rất nhiều, và BroadNet chỉ ghi hỗ trợ tool cho GLM 5.3 và Qwen3.8 27B.

### Có dùng goose với gói không giới hạn của BroadNet được không?

Các gói chỉ gồm DeepSeek V4.1 Flash, và tài liệu BroadNet không ghi gọi tool cho model này. goose nói model không có gọi tool chỉ có thể chat khi tắt hết extension, nên hãy thử trước khi mua một tháng.

### goose lưu API key ở đâu?

Trong keychain của hệ thống, hoặc trong secrets.yaml nếu keyring bị tắt. Khi dùng file JSON, goose đọc biến môi trường có tên ghi trong api\_key\_env.

## Hướng dẫn liên quan

-   [Dùng Kilo Code với BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/vi/guides/kilo-code-openai-compatible/)
-   [Thêm BroadNet Inference vào opencode làm custom provider](https://broadrouter.com/vi/guides/opencode-custom-provider/)
-   [Gói LLM API không giới hạn cho agent hoạt động thế nào?](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

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-guides-goose-custom-provider&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu goose, Model providers và Configure Custom Provider (kiểm tra ngày 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose trên GitHub (aaif-goose/goose), mới nhất là v1.59.1 (kiểm tra ngày 2026-11-15)](https://github.com/aaif-goose/goose)
-   [Tài liệu tham chiếu API 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-guides-goose-custom-provider&utm_content=sources)
