WHEN HOTLINE
用 Hotline 当你想……
你是个人或小团队，想把能力产品化——需要身份、发现、版本和按次结算；或者你是 Agent 团队，想用一份 client 统一调用多个供应商。
选 HOTLINE
KEY TAKEAWAYS
3 句话讲完
- API 是接口标准，Hotline 是能力产品化契约——层级不同。
- 一根 Hotline 可以暴露为 OpenAPI endpoint，两者可以共存。
- Hotline 额外提供身份、发现、版本、计量和评分，面向个人或小团队的能力分发。
DIMENSIONS
维度对照
每行包含「Hotline 怎么做」「传统 API 怎么做」与「这个差异为什么对你重要」。
维度
HOTLINE
传统 API
面向的供给方
个人或小团队；个人身份即可发布能力
为什么重要
Hotline 让个人也能把能力产品化，API 更适合组织化的服务提供。
适合公司或平台提供稳定服务，通常有完整的商务与运维体系
Caller 接入方式
拉 catalog → 直接 call；共享协议级 client
为什么重要
调用多个供应商时，协议统一的接入成本更低。
读 OpenAPI / SDK → 写 client → 处理鉴权 / 限流
返回结构
所有 Hotline 共享 result_package，Agent 只学一次
为什么重要
影响 Agent 能否泛化「调外部能力」这个动作。
每个 API 自定义 schema，灵活但需要逐个适配
计费形态
按次协议结算，分账自动到 Responder
为什么重要
不同场景适合不同计费形态。
按 plan / quota / token 等形式，通过商业合同结算
鉴权 / 限流
协议级 token + 限频策略，Console 一键配置
为什么重要
协议统一的鉴权降低双方的工程负担。
各提供方自行实现鉴权与限流方案
可同时使用？
可以——Hotline 内部实现可以是对一组 API 的封装
为什么重要
「拿 API 做内部实现 + 对外发 Hotline」是常见模式。
同上
WHEN 传统 API
用 传统 API 当你想……
你是公司或平台，已有完整的 OpenAPI / SDK / 商务合同体系，面向稳定的客户群提供服务——API 在这个场景下成熟高效。
不必 HOTLINE
PAGE FAQ
关于 传统 API 的常见疑问
我已经有 OpenAPI service，要重做吗？
不需要。Hotline 的 http adapter 直接对接已有 service：你写一份 input/output schema 与一段转发逻辑（通常 ≤ 50 行），原 service 继续跑，对外多了一层协议化的身份与结算。
Caller 调 Hotline 时怎么鉴权？
client SDK 自动注入协议级 token，Responder 在 supervisor 端只看一个 caller_id 与权限标记，无需自己实现鉴权。Caller Console 可针对每根 Hotline 设置最大频率与每日预算。
Hotline 能像 API 一样按 plan 收费吗？
现阶段 Hotline 的计费颗粒度是「按次 + 按 elapsed_ms」，不强制 plan 模型；如果你需要 plan / 包月，可以在自己的 Responder 实现里做 quota，对外仍然按次暴露。
Hotline 有哪些防滥用机制？
三层：1) Caller 调用走协议级 token，匿名调用拒绝；2) Responder 可设置最低单价与最低预付；3) 调用前 Caller Console 显示 estimated cost 给用户确认。
Hotline 能 stream 大数据吗？
可以。result_package 支持流式分包，Responder 可以分多次写 partial output，Caller 端按 chunk 解析。实际大数据场景通常走对象存储 + Hotline 返回 URL 的方式。