ZK LLM Relay API

Privacy relay for encrypted gateway envelopes.

Endpoints

• GET /healthz - Liveness check
• POST /relay - Forward encrypted envelope to gateway
• GET /docs - This page
• GET /openapi.json - OpenAPI document

Health Check

curl -sS https://proxy.zerok.cloud/healthz

Relay Request

Submit a JSON Envelope payload from the client.

curl -sS https://proxy.zerok.cloud/relay \
  -H "content-type: application/json" \
  -d '{"v":1,"token_class":"c256","eph_pubkey_b64":"...","nonce_b64":"...","ciphertext_b64":"..."}'

Notes

• The relay cannot decrypt payload contents.
• The client needs GATEWAY_PUBLIC_KEY_B64 from the gateway operator.
• Machine-readable spec: /openapi.json
• See the workspace README for full setup and client usage details.