One API for several providers
The gateway speaks the OpenAI chat-completions shape. Change base_url and the key; the rest of your client code stays as it is. It also serves embeddings, audio and a model list. There is no /v1/messages route.
honest-router sends your request to the model provider you named and returns a signed receipt: the model you asked for, the provider that answered, and a hash of the request. You verify the receipt yourself, in a browser or on the command line. A receipt covers what the gateway did. It cannot prove what a provider runs behind its own API.
honest-router is a product of Genupixel Technology Pte. Ltd., a software company registered in Singapore (UEN 202311353N). Company details
{
"schema": "honest-router/basic-receipt-v2",
"trace_id": "t_…",
"requested_model": "…",
"resolved_provider": "…",
"upstream_model": "…",
"request_commit_hash": "…",
"signing_key_id": "…",
"trace_signature": "…"
}
The gateway speaks the OpenAI chat-completions shape. Change base_url and the key; the rest of your client code stays as it is. It also serves embeddings, audio and a model list. There is no /v1/messages route.
Each successful, billed call returns a receipt signed with Ed25519. It states the model you requested, the provider that answered, the model name the gateway sent upstream, and a commitment to the bytes of your request. A failed call gets no receipt.
When a provider fails, the error body carries the provider and its status code, a trace_id and a next step you can act on. A 5xx is never rewritten as a 4xx, and a failure never returns 200.
router.example stands for the gateway host you receive with early access.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 and in the X-A2Auth-Receipt header.GET /v1/receipts/<trace_id> returns a receipt without a key, so a third party can check it too.The gateway signed the receipt and nobody has changed it since. The signed statements include:
With the Merkle and anchor checks, it also proves that the receipt is in a batch whose root is anchored to a transparency log: a GitHub repository and the Software Heritage archive.
A receipt does not prove the price you paid. Compare your statement with the provider's public price list. Prices and fees can change before launch.
honest-router is in pre-release. Until the public launch, access is by request: write to hello@genupixel.xyz and say which models you plan to call and at what volume.