在浏览器里验证
验证页面接受回执文件、粘贴的 JSON,或者一个 trace_id。回执不会被上传到任何地方去检查。页面从网关取公钥和证明,从 GitHub 取锚定记录。
通过 honest-router 的每次成功并计费的调用,都会返回一张回执。本页说明回执里有什么、验证程序检查什么,以及检查到哪里为止。
| 字段 | 含义 |
|---|---|
trace_id | 本次调用的标识,以 t_ 开头。 |
requested_model | 你发送的模型标识。 |
resolved_provider | 实际应答的服务商。 |
upstream_model | 网关发给该服务商的模型名。 |
request_commit_hash | 对请求字节的承诺哈希。 |
response_metadata_hash | 响应元数据的哈希。 |
signing_key_id | 签署这张回执的网关密钥。 |
trace_signature | Ed25519 签名。 |
prev_trace_hash | 同一账户上一张回执的哈希。同一账户的回执由此连成一条链。 |
回执在响应体的 _a2auth.receipt 字段和 X-A2Auth-Receipt 响应头里;流式响应的回执在最后一个 SSE 事件里。任何人都可以用 GET /v1/receipts/<trace_id> 再次取回,不需要密钥。
回执用 Ed25519 签名。对应的公钥公布在 /.well-known/honest-router-pubkey。
回执通过 request_commit_hash 对请求的原始字节作出承诺。
网关把最多 1,024 张回执归为一个批次,为这个批次计算一个根哈希并对它签名。验证程序检查你的回执在这个批次里。批次关闭后才有证明,最长需要 5 分钟。
每个批次的根哈希发布到两个相互独立的地方:一个 GitHub 仓库和 Software Heritage 存档。验证程序拿根哈希与两处对照。
锚定检查有局限。它不能说明该提交今天仍在分支上;而且这个 GitHub 仓库属于网关的运营方,也就是我们自己。
验证页面接受回执文件、粘贴的 JSON,或者一个 trace_id。回执不会被上传到任何地方去检查。页面从网关取公钥和证明,从 GitHub 取锚定记录。
honest-verify 在终端里检查一张回执。加上 --pubkey-hex 和 --no-external,它不会访问 GitHub 和 Software Heritage。
两种工具都随早期访问提供。
网关保存请求和响应的哈希,不保存内容。一个例外:部分带 Idempotency-Key 的请求,网关会保留第一次的响应,默认 14 天。你调用的服务商会收到请求内容,它如何处理由该服务商的条款决定。