服务商的模型目录常常在同一页里混着三类条目:现在就能调用的模型、可以申请的模型,以及服务商只是测试过的模型。在表格里它们看起来差不多,可一旦你要写代码调用,它们就完全不同了。本文以 BroadNet 的目录为例,教你如何分辨它们。BroadRouter 是 BroadNet 自己的网站,所以本文引用的每个 BroadNet 页面我们都在 2026 年 11 月 15 日核对过,关键之处直接引用原文,而不是转述。
目录条目分哪三类?
| 状态 | 含义 | 你需要什么 | 怎么调用 |
|---|---|---|---|
| 已上线(Live) | 在公开价目表上,有公开价格 | 一个账户和一个有资格的密钥 | 在公开 base URL 上使用公开模型 ID |
| 按需提供(On request) | 服务商可以部署,但不能自助开通 | 一次咨询和一份协议 | 通常是专属模型 ID 或端点 |
| 研究(Research) | 测试过、做过基准测试、量化过或已排除 | 无;它不出售 | 无法调用 |
陷阱在第三行。一个如实公开研究的服务商,列出的模型会远多于它销售的模型。这些信息有助于了解它如何挑选模型,但并不是可用性声明。
BroadNet 的目录是怎么展示的?
BroadNet 的模型目录把三类都放在一页上,顺序如下:
- “Live on the Inference API”(已在 Inference API 上线)。 方框中写着:“These models are on the rate card today.”(译文:这些模型如今已在价目表上。)
- “Available on request”(按需提供)。 三个条目:BroadNet 对 Cohere Transcribe Arabic 的微调版、Qwen3-VL 30B-A3B Instruct 和 Qwen3-VL 8B Instruct。它们的模型页面写着 “private id issued per customer”(译文:为每位客户签发专属 ID)。
- “The catalogue”(目录)。 BroadNet 称在其实验室运行过的每一个模型(约 270 个,统计于 2026 年 9 月),标注为 PROD(承载过线上流量)、SERVED、BENCH、QUANT、FT 或 RULED OUT。它按语言模型、语音转文字、文本转语音、OCR、embedding、图像和视频生成等分组。
- “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 的条款说,专属端点和预留容量遵循单独的书面协议。价格、可用性和处理地点以该协议为准,而不是以公开页面为准。
依赖某个模型之前的五步检查
对你打算依赖的每个模型都做一遍,无论在哪家服务商:
- 在价目表或价格数据中找到它,而不只是在博客文章、模型页面或基准测试表里。
- 从 API 参考中复制确切的 ID。 名称会漂移:版本后缀、“Flash”和“Pro”变体,以及
broadnet/这样的服务商前缀都很重要。 - 检查访问权限。 你的密钥或套餐覆盖它吗?在 BroadNet 上,
paid_only模型需要充值,DeepSeek 会话套餐只覆盖 DeepSeek V4.1 Flash。 - 在文档中确认你需要的能力在该模型上可用,例如图像、工具或结构化输出。一个模型有某项能力,不代表下一个模型也有。
- 用一个真实的提示词发送一次请求,并保存响应的请求 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 如何挑选模型,以及它公开的排除部分模型的理由,但请把其中每一行都当作证据,而不是销售承诺。
