用户不用重复注册
已经有 HarperHarbor 账号的人，一键就能登录你的应用，余额也一起带过来。
我们先拿它跑自己的产品，现在把它开放出来。
你接入的，就是驱动我们自己的对话舞台与社区酒馆的那套账号、钱包与模型线路。没有另一个“合作伙伴”版本。
你的产品会少做哪些事
你不用碰钱
充值、退款、争议与收据是平台的事。你的应用只读余额、发请求。
换模型不用上线
每个模型都藏在有名字的线路后面，自动备援。上游降级时流量自动切走，并告知用户。
底下是什么
每个陪伴型产品都需要、却不该重做第二次的六件事。
身份与钱包
一个账号、一份预付余额，跨应用共用。应用是用户的分组，永远不是拥有者。
人格运行时
卡片游玩、开场白、作者显示规则与记忆，以服务的形式提供，而不是某一个产品的聊天画面。
模型线路
每个模型背后有多家上游，对外只公布稳定的代号。路由、健康探测与备援由我们负责。
边界
固定角色、服务器端强制的应用范围查询、上游名称永不外露、每笔管理操作都有审计。
计量
每次调用都是一笔带用户、应用、服务、线路的事件。每日汇总与钱包对账，差额必须为零。
开放 API 与 MCP
冻结的 v1 契约，人用 OAuth 2.1，AI 客户端用只读 MCP 工具——同一套服务层、同一套规则。
控制台已经在跑
先看要处理的事，再看数字：线路健康、配额压力、对账结果在同一个画面。你看到的，就是你的团队将来用的那一个控制台。
# 1. exchange the authorization code (PKCE)
curl -X POST https://api.harperharbor.com/oauth/token \
-d grant_type=authorization_code -d code=$CODE \
-d client_id=$CLIENT_ID -d redirect_uri=$REDIRECT_URI \
-d code_verifier=$VERIFIER -d resource=https://api.harperharbor.com/open/v1
# 2. who is signed in
curl https://api.harperharbor.com/open/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "language: en"按用量付费，没有月费。
用户预付点数，应用免费接入。每个模型与线路的价格在任何人花掉一点之前就已公开。
用户预付点数
点数不过期。每次调用都从用户唯一的钱包扣，不管是哪个应用发起的。
应用不付钱
没有席位费、没有分成、没有最低消费。唯一的限制是保护平台的每日配额。
价格公开
每个模型与线路的单价在控制台与产品内使用当下都看得到。
边界清楚
- 01
应用只看得到自己的用户
看不到余额，看不到其他应用的行为。范围在查询层强制，不是靠界面遮。
- 02
每笔管理操作都有审计
谁、何时、做了什么、通过哪个渠道——控制台、API、SSO 或定时任务。保留 180 天。
- 03
用户可以离开
用户一键就能解除任何应用的授权，该应用的 token 立即失效。
常见问题
这是角色聊天 API 吗？
卡片游玩是第一个服务，但产品是底下那一层：共用身份、唯一钱包、模型线路、计量与边界。任何陪伴型体验都能放在上面。
我想自己向用户收费怎么办？
那目前还不适合你。HarperHarbor 上的应用不收费也不结算，这是“永远不碰钱”的交换条件。结算在路线图上，但不是承诺。
你们跑哪些模型？
我们公布线路，不公布供应商名称。线路是一个稳定代号，带实时健康状态与价格；背后可能有多家上游，流量会在它们之间移动。