直接回答
model catalog API 是一层专门提供模型范围、公开模型名、调用入口、路由组和进一步查询路径的目录接口。它的价值在于把“页面上先看懂范围”和“系统里再看更细事实”分成两个协同层次。
展开说明
把这个问题拆成三个更容易判断的部分。
答案页不追求大而全，而是先给直接回答，再把为什么重要、为什么不能简化、35m.ai 怎么处理这件事拆开讲清楚。
为什么模型目录不能只有静态页面
静态页面适合解释主题和范围，但一旦涉及供应商状态、细粒度入口或更深的差异，就需要目录接口继续承接。
- 静态页面帮助用户先知道“这里能接什么”。
- 目录接口帮助系统继续知道“这些模型现在属于哪类入口和路由组”。
为什么目录接口也不能替代页面
单纯给一个 JSON 并不能替代对主题的解释。用户和搜索系统都需要先看到结构化文本，再决定是否深入接口层。
- 静态页更适合 SEO、AEO 和第一次理解。
- 目录接口更适合程序化消费和动态细节查询。
35m.ai 的目录层怎么分工
35m.ai 把静态模型页、公开模型目录和更细的 provider 对比接口拆开，让不同层次的用户都能在合适位置拿到信息。
- 模型页先解释模型范围、公开模型名、路由组和调用入口。
- GET /v1/models 继续提供程序可读的目录层。
常见问题
继续把常见误解讲清楚。
如果用户已经理解主答案，这一组问题通常就是他们下一步会继续确认的边界。
静态模型页的数据会实时变化吗？
不一定。静态页主要承担解释范围和入口的职责，实时变化更适合放在目录接口层。
什么时候应该直接读 /v1/models？
当你需要程序化消费模型列表、入口或路由信息时，直接读目录接口更合适。
相关问题
继续看这些相关问题。
把主题做成彼此可连接的答案页，会比把所有解释塞回首页更利于理解和搜索发现。