Providers API（TypeScript）导读

大多数团队不需要每天查 provider，但在做 BYOK、fallback 或健康排查时，这组接口会很有用。

client.providers 不是首次接入必须学的模块，但它对 BYOK 配置、fallback 可解释性和健康排查很有帮助。它的重点不在“看到很多 provider”，而在于判断某个 provider 当前是否适合你的流量。

最值得先记住的 3 个方法

Name	Type	Required	Description
client.providers.list	function	Required	列出 provider。适合做健康巡检、选择面板和 BYOK 治理视图。
client.providers.retrieve	function		查看单个 provider 的详情。适合排查具体 provider 的区域和能力信息。
client.providers.health	function		查看健康状态。适合解释 fallback、故障切换和局部退化。

list

const providers = await client.providers.list({
  region: "us",
  status: "healthy",
});

console.log(providers.data);

Name	Type	Description
provider_id	string	目标 provider 标识。单 provider 详情和健康检查都要用到。
region	string	区域过滤。多区域部署或合规边界判断时有用。
status	string	健康状态过滤。适合只看 healthy / degraded 的 provider 列表。
include_health	boolean	是否把健康数据一起带回来。排查故障时常用，普通展示页不一定需要。

不要把 provider 列表当成模型选择器

provider 接口主要用于查看 provider 状态与健康信息，不是默认的模型推荐入口。模型选择仍应以模型目录和实际使用场景为主。

text

1. 把 provider 列表当成“用户应该自己选很多 provider”的 UI 基础。
2. 不看健康状态，只看 provider 名字。
3. 想解释 fallback，却只盯着模型层，不看 provider 层。
4. 做 BYOK 治理，却没有 provider 维度的可见性。

如果你更想从 HTTP 接口理解返回字段和过滤参数，这页更直接。

如果你查看 provider 的目的，是为了理解 routing 与 fallback，就可以继续看这页。

provider 解决的是执行面，模型页解决的是能力选择面，这两页常常要一起看。