BroadRouter

已上线、按需提供、仅研究:看懂模型目录

BroadNet Inference 团队 · 阅读约 7 分钟 · 发布于 · 更新于

能调用的模型,在服务商的价目表或价格数据中有确切的 API ID、公开的价格和 live(已上线)状态。按需提供的模型需要先咨询,通常会拿到一个专属模型 ID。研究条目记录的是服务商测试过什么,无法调用。先读价格数据和 API 参考,再用一个请求确认。

服务商的模型目录常常在同一页里混着三类条目:现在就能调用的模型、可以申请的模型,以及服务商只是测试过的模型。在表格里它们看起来差不多,可一旦你要写代码调用,它们就完全不同了。本文以 BroadNet 的目录为例,教你如何分辨它们。BroadRouter 是 BroadNet 自己的网站,所以本文引用的每个 BroadNet 页面我们都在 2026 年 11 月 15 日核对过,关键之处直接引用原文,而不是转述。

目录条目分哪三类?

状态 含义 你需要什么 怎么调用
已上线(Live) 在公开价目表上,有公开价格 一个账户和一个有资格的密钥 在公开 base URL 上使用公开模型 ID
按需提供(On request) 服务商可以部署,但不能自助开通 一次咨询和一份协议 通常是专属模型 ID 或端点
研究(Research) 测试过、做过基准测试、量化过或已排除 无;它不出售 无法调用

陷阱在第三行。一个如实公开研究的服务商,列出的模型会远多于它销售的模型。这些信息有助于了解它如何挑选模型,但并不是可用性声明。

BroadNet 的目录是怎么展示的?

BroadNet 的模型目录把三类都放在一页上,顺序如下:

  1. “Live on the Inference API”(已在 Inference API 上线)。 方框中写着:“These models are on the rate card today.”(译文:这些模型如今已在价目表上。)
  2. “Available on request”(按需提供)。 三个条目:BroadNet 对 Cohere Transcribe Arabic 的微调版、Qwen3-VL 30B-A3B Instruct 和 Qwen3-VL 8B Instruct。它们的模型页面写着 “private id issued per customer”(译文:为每位客户签发专属 ID)。
  3. “The catalogue”(目录)。 BroadNet 称在其实验室运行过的每一个模型(约 270 个,统计于 2026 年 9 月),标注为 PROD(承载过线上流量)、SERVED、BENCH、QUANT、FT 或 RULED OUT。它按语言模型、语音转文字、文本转语音、OCR、embedding、图像和视频生成等分组。
  4. “Remote and API models benchmarked”(做过基准测试的远程和 API 模型)。 用 BroadNet 的原话说:“About 90 models we never ran on our hardware but pushed through our safety, routing and Arabic harnesses.”(译文:约 90 个我们从未在自有硬件上运行过、但跑过我们的安全、路由和阿拉伯语测试套件的模型。)其中点名了 Anthropic、OpenAI、Google、Meta 等公司的模型。

只有第一组能用自助申请的密钥调用。第三组和第四组包括文本转语音、图像生成和 embedding 模型,而 BroadNet 的公开 API 一个都不提供。在表里看到 FLUX 或某个 Claude 模型,只说明 BroadNet 测量过它,不说明你能向它发送请求。BroadNet 给出的排除理由汇总在 BroadNet 排除的模型一文中,硬件方面见 BroadNet 的 GPU 硬件与推理服务。

哪个来源才是价目表?

机器可读的那个。BroadNet 发布了 pricing.json,其 API 参考称它是 “the same file our pricing and plans pages are built from”(译文:我们的价格和套餐页面正是基于这个文件生成的)。它为每个模型提供:

  • id:作为 model 发送的确切字符串;
  • status:live 或 on_request;
  • paid_only:模型需要一次符合条件的充值后才开放时为 true;
  • 价格、context_length,对话模型的 modalities,以及转写模型的 languages。

2026 年 11 月 15 日,这份数据列出了六个已上线模型:DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B、Gemma 4 VL 26B、BroadNet Transcribe Arabic 和 BroadNet Transcribe。API 参考的模型表列出的是同样六个 ID。

同一天,目录页的 “Live on the Inference API” 方框只显示了其中四个:漏掉了 GLM 5.3 和 Qwen3.8 27B,我们在 2026 年 11 月 16 日复查时仍是如此。(Qwen3.8 27B 出现在下方实验室表格中,标为 SERVED。)我们不知道是哪个页面没有及时更新,也无法用付费请求来确认。这在任何服务商的网站上都很常见,这也正是为什么你应该以价格数据和 API 参考为准来决定发送什么,然后再测试。

GET /v1/models 可信吗?

要看它对每家服务商分别意味着什么。OpenAI Python SDK 的文档说 models.list() 列出 “the currently available models”(译文:当前可用的模型),很多工具会调用它来填充模型选择器。其他 OpenAI 兼容 API 的实现方式则各不相同。

BroadNet 的 API 参考写道:“Use the model IDs in this reference for direct API requests. GET /v1/models supplies public catalogue metadata for external monitors.”(译文:直接发起 API 请求时,请使用本参考中的模型 ID。GET /v1/models 为外部监控工具提供公开的目录元数据。)我们在 2026 年 11 月 15 日不带密钥调用它时,它只返回了 broadnet/cohere-transcribe-arabic 和 broadnet/cohere-transcribe,每条都带有 input_modalities、capacity 等字段,以及一个值为 false 的 is_ready 标志。四个已上线的对话模型一个都没有列出。所以,只从 /v1/models 构建模型列表的工具,在 BroadNet 上会显示不出任何对话模型;请手动输入模型 ID,OpenAI 兼容 API 的 base URL一文介绍了其他客户端的做法。

怎么用代码检查状态?

下面的脚本读取 BroadNet 的公开价格数据和 /v1/models,两者都不需要密钥,并打印每个模型的状态和访问条件。把它放进 CI 运行是安全的,可以发现模型被新增、改为按需提供或下线。

import json, urllib.request

FEED = "https://inference.broadnet.ai/pricing.json"
MODELS = "https://inference.broadnet.ai/v1/models"

def get(url):
    req = urllib.request.Request(url, headers={"User-Agent": "catalogue-check/1.0"})
    with urllib.request.urlopen(req, timeout=30) as r:
        return json.load(r)

feed = get(FEED)
assert feed["schema_version"] == 1, "unknown feed schema: re-read the docs before trusting it"
print(f"prices updated {feed['updated']}")
for m in feed["models"]:
    status = m.get("status", "live")                       # docs: live or on_request
    access = "top-up required" if m.get("paid_only") else "open from sign-up"
    inputs = ", ".join(m.get("modalities", [])) or f"audio, {m.get('language_count', len(m.get('languages', [])))} language(s)"
    print(f"{status:10} {m['id']:36} {m['kind']:5} {inputs:22} {access}")

listed = {m["id"] for m in get(MODELS)["data"]}
callable_ = {m["id"] for m in feed["models"] if m.get("status", "live") == "live"}
print("live in the feed but not in /v1/models:", sorted(callable_ - listed))
print("in /v1/models but not live in the feed:", sorted(listed - callable_))

2026 年 11 月 15 日实际运行时,它输出:

prices updated 2026-11-14
live       broadnet/deepseek-v4.1-flash         chat  text, image            top-up required
live       broadnet/glm-5.3                     chat  text                   top-up required
live       broadnet/qwen3.8-27b                 chat  text, image            top-up required
live       broadnet/gemma-4-26b-a4b             chat  text, image            open from sign-up
live       broadnet/cohere-transcribe-arabic    stt   audio, 1 language(s)   open from sign-up
live       broadnet/cohere-transcribe           stt   audio, 14 language(s)  open from sign-up
live in the feed but not in /v1/models: ['broadnet/deepseek-v4.1-flash', 'broadnet/gemma-4-26b-a4b', 'broadnet/glm-5.3', 'broadnet/qwen3.8-27b']
in /v1/models but not live in the feed: []

“Open from sign-up”(注册后即可使用)是我们的脚本给没有 paid_only 的行加的标签,并不是这份数据中的字段;在 BroadNet 上,这意味着 $5 初始额度可以用于它。schema_version 检查遵循文档的说明:只有当某个已有字段的含义改变时版本号才会变,而新字段随时可能出现。

最后一步检查是发一个请求。按 cURL 快速入门用模型 ID 和一段简短提示词调用一次:如果该模型对你的密钥已上线,就会返回 200;否则会返回带有机器可读错误码的错误。

“按需提供”实际上是什么样子?

BroadNet 的按需提供模型页面展示了有哪些不同。例如 Qwen3-VL 30B-A3B 页面上没有价格,而是一个 “Ask for access”(申请访问)按钮,模型 ID 一栏写着 “private id issued per customer”(译文:为每位客户签发专属 ID),上下文为 16K token。BroadNet 对 Cohere Transcribe Arabic 的微调版也是如此。BroadNet 的 API 参考解释了这一机制:专属端点、它的阿拉伯语微调模型和其他按需提供的模型 “are reached with a private ID issued with the endpoint.”(译文:通过随端点一起签发的专属 ID 调用。)

这对你的代码和计划有三点影响:

  • 没有可以写死的公开 ID。 在服务商签发 ID 之前,你没法写请求,所以要把模型 ID 放在配置里,而不是代码里。
  • 限制不同。 按需部署的上下文窗口、速率限制和区域,可能和公开价目表上的任何模型都不同。请对方书面提供。
  • 条款不同。 BroadNet 的条款说,专属端点和预留容量遵循单独的书面协议。价格、可用性和处理地点以该协议为准,而不是以公开页面为准。

依赖某个模型之前的五步检查

对你打算依赖的每个模型都做一遍,无论在哪家服务商:

  1. 在价目表或价格数据中找到它,而不只是在博客文章、模型页面或基准测试表里。
  2. 从 API 参考中复制确切的 ID。 名称会漂移:版本后缀、“Flash”和“Pro”变体,以及 broadnet/ 这样的服务商前缀都很重要。
  3. 检查访问权限。 你的密钥或套餐覆盖它吗?在 BroadNet 上,paid_only 模型需要充值,DeepSeek 会话套餐只覆盖 DeepSeek V4.1 Flash。
  4. 在文档中确认你需要的能力在该模型上可用,例如图像、工具或结构化输出。一个模型有某项能力,不代表下一个模型也有。
  5. 用一个真实的提示词发送一次请求,并保存响应的请求 ID。如果这个模型很关键,就在 CI 里重复这一步。

绝不应该从目录中推断出什么?

  • 做过基准测试的模型就在出售。 研究表里的一行,只是一次测量。
  • 按需提供就意味着很快能用。 它意味着要沟通。BroadNet 把按需提供的模型、专属端点和区域化处理都作为咨询项,通过联系页面受理;参见规划专属端点。
  • 某项能力适用于所有模型。 BroadNet 的文档说,视觉能力 “offered only where the model row explicitly says images or vision”(译文:仅在模型行明确标注图像或视觉时提供),并且只为 GLM 5.3 和 Qwen3.8 27B 提供了工具调用的文档说明。文本、语音还是视觉把各类任务对应到接受相应输入的模型。
  • 今天的清单是永久的。 BroadNet 的条款(第 7.4 条)说,它可能更改、暂停或下线某个模型或功能,并在可能时在目录页上给出合理的提前通知。自助服务没有可用性承诺;服务等级只存在于单独的书面协议中。
  • 同一个模型名称在哪里都指同一个模型。 BroadNet 的远程清单中有 “GLM 5.3 Flash”,它并不是价目表上的 broadnet/glm-5.3。一定要复制确切的 ID。

同样的检查适用于任何服务商。我们的服务商选择清单列出了其余需要问的问题。

BroadNet Inference 处在什么位置

BroadNet Inference 已上线的模型和价格见我们的模型和价格页面,它们基于同一份 pricing.json 生成。BroadNet 按需提供的模型单独列在按需提供下。broadnet.ai 上的研究目录值得一读,可以了解 BroadNet 如何挑选模型,以及它公开的排除部分模型的理由,但请把其中每一行都当作证据,而不是销售承诺。

常见问题

怎么知道一个模型能不能通过 API 调用?

它必须在服务商的价目表或机器可读的价格数据中有确切的 API ID、公开的价格和 live 状态,而且你的密钥要有资格调用它。然后发一个小请求。返回 200 且带着该模型 ID,就是证明。

“按需提供”(available on request)是什么意思?

服务商可以为你部署这个模型,但不能通过自助申请的密钥使用。你需要提交咨询、商定条款,通常会拿到一个专属模型 ID 或端点。在 BroadNet,按需提供的模型通过随端点一起签发的专属 ID 调用。

为什么研究或基准测试表里列出的模型调用不了?

因为那张表记录的是服务商测试过什么,而不是它卖什么。BroadNet 的目录列出了它做过基准测试的文本转语音、图像生成和 embedding 模型,以及约 90 个它称从未在自有硬件上运行过的远程模型。这些都没有公开的 API ID 或价格。

GET /v1/models 会列出我能用的所有模型吗?

不一定。在 OpenAI API 中,它列出当前可用的模型,但其他服务商的实现方式不同。2026 年 11 月 15 日,BroadNet 的这个接口只返回了两个转写模型,它的文档说该接口为监控工具提供目录元数据;请使用 API 参考中的 ID。

BroadNet 的哪些模型需要充值才能用?

在 2026 年 11 月 15 日的 pricing.json 中,DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 标有 paid_only,需要一次符合条件的充值后才开放。Gemma 4 VL 26B 和两个转写模型注册后即可使用,用初始额度就行。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity