WHEN HOTLINE
用 Hotline 当你想……
你想以个体身份长期对外提供能力、被各类 Agent 自动发现并按次付费；或者你是 Agent 团队，想要一份 client 通吃任意供应商，不再为每家 API 单独维护接入。
选 HOTLINE
KEY TAKEAWAYS
3 句话讲完
- API 假设供给方是公司，Hotline 假设供给方是个体。
- API 每家一份 client；Hotline 全协议共享一份 client + result_package。
- API 计费走商业合同，Hotline 计费走协议层。
DIMENSIONS
维度对照
每行包含「Hotline 怎么做」「传统 API 怎么做」与「这个差异为什么对你重要」。
维度
HOTLINE
传统 API
供给方画像
OPC / 超级个体；个人身份即可发布
为什么重要
把「能挂能力」的人群从万家公司扩大到亿级个体。
公司主体；通常需要营业执照、对公账户、合同
Caller 接入成本
拉 catalog → 直接 call；不写 client
为什么重要
Agent 想用 100 根能力时，差异从「100 倍」变成「1 倍」。
读对方 OpenAPI / SDK → 写 client → 处理鉴权 / 限流
返回结构
所有 Hotline 共享 result_package，Agent 只学一次
为什么重要
影响 Agent 能否泛化「调外部能力」这个动作。
每个 API 自定义 schema，Agent 要学 N 套
计费形态
按次协议结算，分账自动到 Responder
为什么重要
OPC 卖一根 Hotline 不需要谈商务。
按 plan / 按 quota / 按 token；要走商业合同
鉴权 / 限流
协议级 token + 限频策略，Console 一键配置
为什么重要
降低 Caller 与 Responder 双方的工程负担。
每家自实现：API key / OAuth / IP 白名单 / 请求签名
可同时使用？
可以——Hotline 内部实现可以是对一组 API 的封装
为什么重要
「拿 API 做内部实现 + 对外发 Hotline」是 OPC 常见模式。
同上
WHEN 传统 API
用 传统 API 当你想……
你的供给方就是公司，已有完整的 OpenAPI / SDK / 商务合同，Caller 也只是少数几家、量级巨大；这种场景继续走 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 与权限标记，无需自己解析 JWT / OAuth。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 的方式，更稳定。