Providers API（Python）导读

如果你的管理脚本和巡检任务主要跑在 Python，这组接口会更方便。

如果你的管理脚本、巡检任务或自动化系统主要在 Python，client.providers能把 provider 信息纳入同一套 SDK 工作流。它的重点不在“知道有哪些 provider”，而在于让 BYOK、健康、区域和 fallback 变得可查询、可解释。

最值得先记住的 3 个方法

Name	Type	Required	Description
client.providers.list	function	Required	列出 provider，适合巡检和管理视图。
client.providers.retrieve	function		查看单 provider 详情，适合排查区域、能力和配置差异。
client.providers.health	function		查询健康面，适合解释为什么某段时间 fallback 增多。

list

providers = client.providers.list(region="us", status="healthy")

for provider in providers.data:
    print(provider["id"], provider["name"])

Name	Type	Description
provider_id	string	目标 provider 标识。详情和健康查询都需要它。
region	string	区域过滤。多区域部署或合规要求下很常见。
status	string	健康状态过滤。你不需要总看全部 provider。
include_health	boolean	把健康信息一起带出来，适合故障排查或巡检使用。

正确的使用位置

把 provider API 放在管理脚本、巡检任务和故障分析里，而不是首次接入路径里。你的默认用户不应该被迫在 provider 列表里做复杂选择。

text

1. 用 provider 列表替代模型默认值策略。
2. 想做 fallback 解释，却没有 provider 健康数据。
3. 只在 dashboard 里肉眼查看，不把 provider 信息纳入自动治理脚本。
4. 把区域、健康、BYOK 边界混成一件事。

如果你想看底层 HTTP 契约，而不是 SDK 包装层，这页更直接。

如果你查 provider 的真实目的，是解释 fallback 或 shared / BYOK 行为，就去这页。

provider 维度治理通常最终要回到 analytics 和 spend 视图，这页能接上。