Responses (ZeroClick)
OpenAI-style Responses inference authenticated by a ZeroClick HMAC signature instead of an API key.
/v1/responses — only authentication, authorization, and metering differ.
- Authentication — no
x-api-key. A buying agent calls ZeroClick’s hosted pay URL; ZeroClick proxies the request and signs the raw request bytes with an HMAC in thezc-signatureheader. A request is authenticated only by a valid signature. - Authorization — a ZeroClick allowance check runs before any billable work. It fails open on a transient ZeroClick outage (the signature has already verified), but never for a missing or invalid signature.
- Metering — actual token usage is settled with ZeroClick and reported via the
zc-usageresponse header. Stripe metering is bypassed; ZeroClick is the sole biller.
input and output shapes vary by model; open a model page for a prefilled playground. Handle errors the same way as API error codes.Authorizations
HMAC signature minted by ZeroClick over the raw request bytes, of the
form t=<unix-seconds>,kid=<key-id>,v1=<hex-hmac>. Verified by the
@zeroclickai/sellers SDK against the seller's signing secret keyed by
kid. A missing or invalid signature is rejected with 401
invalid_zeroclick_signature; this is never failed open.
Headers
ZeroClick request id, echoed in logs for correlation. Set by ZeroClick when it proxies the request.
"zcreq_1"
Identifier of the buying agent. Used to partition logs/analytics by agent; becomes the synthesized caller identity.
"agt_1"
Body
"LFM2.5-1.2B-Instruct"
Prompt text. Combined with instructions (as a system message) to form the model input.
System-style instructions prepended to the input. Classification models may pass comma-separated or bracketed candidate labels here.
auto, disabled Candidate labels for text-classification models.
Up to 16 string key/value pairs echoed back in the response envelope. Also carries GLiNER usecase options (usecase, schema, labels, threshold, mask, replacement_char), which are consumed and not necessarily echoed.
Response
OpenAI Responses response object. Includes the zc-usage header settling actual usage with ZeroClick.
OpenAI Responses response object. On error, status is failed and error is populated.
"response"completed, failed Error attached to a Responses envelope. OpenAI's ResponseError carries
code and message; type and param are also emitted by some error
sites on this endpoint.
auto, disabled 
