---
title: "goose 配置 OpenAI 兼容的自定义供应商 | BroadRouter"
description: "把 goose AI agent 接到 BroadNet Inference，作为 OpenAI Compatible 自定义供应商：可以用 goose Desktop、goose configure 或 JSON 文件配置。"
url: https://broadrouter.com/zh/guides/goose-custom-provider/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/guides/goose-custom-provider/)（2026-11-16 更新）。

# 把 BroadNet Inference 作为自定义供应商接入 goose

更新于 2026-11-16

在 goose 中添加一个自定义供应商，类型选 OpenAI Compatible，API URL 填 https://inference.broadnet.ai/v1/chat/completions，再填入 BroadNet 密钥和可用模型（例如 broadnet/glm-5.3）。可以用 goose Desktop 的 Add Custom Provider 按钮、终端里的 goose configure，或 ~/.config/goose/custom\_providers/ 下的 JSON 文件。goose 依赖工具调用，建议先用 GLM 5.3 或 Qwen3.8 27B。

goose 是一个开源的 AI agent，有桌面应用和 CLI。没有内置的服务可以作为**自定义供应商**添加，goose 支持 OpenAI 兼容的供应商。BroadNet Inference 提供标准的 chat completions，因此可以这样接入。BroadRouter 是 BroadNet 自己的网站；下面的步骤依据 goose 1.59 时的 [goose 供应商文档](https://goose-docs.ai/docs/getting-started/providers/)。

goose 的文档提醒，它“extensively uses tool calling”（译文：大量使用工具调用），不支持工具调用的模型只能在禁用所有扩展的情况下聊天。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具调用，做 agent 工作时请用这两个之一。

## 方式一：goose Desktop

1.  打开侧边栏，点击 **Settings**，再进入 **Models** 标签页。
    
2.  点击 **Configure providers**，然后点击底部的 **Add Custom Provider**。
    
3.  填写信息：
    
    | 字段 | 值 |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | 你的 BroadNet 密钥 |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | 开启 |
    
4.  点击 **Create Provider**，然后选中它和一个模型。
    

## 方式二：goose CLI

运行 `goose configure`，选择 **Custom Providers**，再选 **Add A Custom Provider**，按提示填入同样的值：API 类型 OpenAI Compatible，上面的 API URL，认证选 **Yes** 并使用静态 API 密钥，逗号分隔的模型列表，开启流式输出。

## 方式三：JSON 文件

创建 `~/.config/goose/custom_providers/broadnet.json`（Windows 上放在 `%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
}
```

然后用它启动一个会话：

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

由于密钥保存在环境变量里，这个文件可以放进代码仓库与团队共享。

## 测试

先问一个简单的问题，比如“what can you do?”（你能做什么？）。得到回答就说明连接正常。然后让它做一件需要用到已启用扩展的事。如果 goose 调用了工具，说明工具调用也正常。如果它只回复文字、从不调用工具，请换成 `broadnet/glm-5.3`。

## 在 goose 中显示价格

如果 JSON 文件中的每个模型都写了 `input_token_cost` 和 `output_token_cost`（单位为美元/token），goose 就能估算费用。数值取自 BroadNet 的[价格页](https://broadrouter.com/zh/pricing/)，把每百万 token 的价格除以 1,000,000。如果缺少这两个字段，goose 会退回使用它自带目录中的价格，可能与 BroadNet 的价格不一致。

## 故障排查

-   **401。** 密钥不对、已过期或额度已用完，或者启动 goose 的 shell 中没有设置 `BROADNET_API_KEY`。
-   **404。** 检查 API URL，应该是 `https://inference.broadnet.ai/v1/chat/completions`。检查模型 ID 是否与 BroadNet 的完全一致。付费模型需要先充值；$5 额度只覆盖 `broadnet/gemma-4-26b-a4b` 和两个 Transcribe 模型，而 Gemma 32,768 token 的上下文对 agent 工作来说偏小。
-   **回答为空。** 在 DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 上，思考内容计入输出上限。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个进行中的请求。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **两个 goose 会话共用一个套餐密钥时请求等待或失败。** 一个[套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)同一时间只处理一个请求，所以请给每个 goose 会话单独分配一个。

## 本指南涉及的术语

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[工具调用（tool calling / function calling）](https://broadrouter.com/zh/glossary/tool-calling/)

工具调用（也叫函数调用，function calling）是大模型 API 的一项功能：模型返回一个结构化请求，要求执行开发者定义的某个函数，并附上 JSON 参数。应用执行该函数并把结果发回；模型自己从不执行代码。

[流式输出（streaming）](https://broadrouter.com/zh/glossary/streaming/)

流式输出是一种在语言模型仍在生成时，就把回复分成小块陆续返回的方式，而不是在最后一次性返回。当请求把 stream 设为 true 时，OpenAI 兼容 API 会通过服务器发送事件（SSE）进行流式输出。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

[API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/)

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

## 常见问题

### goose 的 API URL 应该以 /v1 结尾，还是以 /v1/chat/completions 结尾？

goose 官方的自定义供应商示例用的是完整的 chat completions 地址，所以请填 https://inference.broadnet.ai/v1/chat/completions。这样也能让 goose 始终走 chat completions，而这正是 BroadNet 提供的接口。

### goose 配哪个 BroadNet 模型效果最好？

GLM 5.3（broadnet/glm-5.3）。goose 的文档说它大量使用工具调用，而 BroadNet 只为 GLM 5.3 和 Qwen3.8 27B 列出了工具支持。

### goose 能用 BroadNet 的不限量套餐吗？

套餐只覆盖 DeepSeek V4.1 Flash，而 BroadNet 的文档没有为它列出工具调用。goose 说不支持工具调用的模型只能在禁用所有扩展的情况下聊天，所以买一个月之前请先测试。

### goose 把 API 密钥存在哪里？

存在系统钥匙串里；如果关闭了 keyring，则存在 secrets.yaml 中。如果用 JSON 文件配置，goose 会改为读取 api\_key\_env 中指定的环境变量。

## 相关指南

-   [在 Kilo Code 中使用 BroadNet Inference（OpenAI Compatible 供应商）](https://broadrouter.com/zh/guides/kilo-code-openai-compatible/)
-   [把 BroadNet Inference 添加为 opencode 的自定义供应商](https://broadrouter.com/zh/guides/opencode-custom-provider/)
-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/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=zh-guides-goose-custom-provider&utm_content=page-cta) ·

**来源**

-   [goose 文档：Model providers 与 Configure Custom Provider（核对于 2026-11-15）](https://goose-docs.ai/docs/getting-started/providers/)
-   [GitHub 上的 goose（aaif-goose/goose），最新版 v1.59.1（核对于 2026-11-15）](https://github.com/aaif-goose/goose)
-   [BroadNet Inference API 参考文档（核对于 2026-11-15）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-goose-custom-provider&utm_content=sources)
