一个接口,多家服务商
网关采用 OpenAI chat-completions 的请求格式。改掉 base_url 和密钥,其余客户端代码不用动。另外提供 embeddings、音频和模型列表接口。没有 /v1/messages 路由。
honest-router 把请求转发给你指定的模型服务商,并返回一张签名回执:你请求的模型、实际应答的服务商、请求内容的哈希。回执由你自己验证,在浏览器里或命令行里都可以。回执只说明网关做了什么,无法证明服务商在自己的 API 背后运行的是什么。
honest-router 是 Genupixel Technology Pte. Ltd. 的产品。这是一家在新加坡注册的软件公司,注册号(UEN)为 202311353N。公司信息
{
"schema": "honest-router/basic-receipt-v2",
"trace_id": "t_…",
"requested_model": "…",
"resolved_provider": "…",
"upstream_model": "…",
"request_commit_hash": "…",
"signing_key_id": "…",
"trace_signature": "…"
}
网关采用 OpenAI chat-completions 的请求格式。改掉 base_url 和密钥,其余客户端代码不用动。另外提供 embeddings、音频和模型列表接口。没有 /v1/messages 路由。
每次成功并计费的调用,都返回一张 Ed25519 签名的回执,写明你请求的模型、应答的服务商、网关发给上游的模型名,以及对请求字节的承诺哈希。失败的调用没有回执。
服务商出错时,错误体带有服务商名称和它的状态码、trace_id,以及你可以照做的下一步。5xx 不会被改写成 4xx,失败也不会返回 200。
router.example 代表网关地址,随早期访问一起提供。from openai import OpenAI
client = OpenAI(
api_key="hr-<your-key>",
base_url="https://router.example/v1",
)
r = client.chat.completions.create(
model="<provider>/<model>",
messages=[{"role": "user", "content": "hi"}],
)
_a2auth.receipt 字段和 X-A2Auth-Receipt 响应头里。GET /v1/receipts/<trace_id> 不需要密钥就能取回回执,第三方也可以验证。网关签署了这张回执,之后没有人改动过。签署的内容包括:
再加上 Merkle 检查和锚定检查,它还能证明这张回执在某个批次里,而该批次的根哈希已锚定到透明日志:一个 GitHub 仓库和 Software Heritage 存档。
回执不能证明你付的价格。请把账单与服务商公开的价格表对照。正式发布前,价格和费率可能调整。
honest-router 处于预发布阶段。公开发布之前,访问需要申请:写信到 hello@genupixel.xyz,说明你打算调用哪些模型、大概多少用量。