v1

latestOpenAPI 3.1.02026-07-26132433.7 KB

ZeroClick

Create a chat completion (ZeroClick-authenticated)

OpenAI-style Chat Completions endpoint, authenticated by verifying the zc-signature HMAC over the raw request bytes. The request is routed by model using model metadata, and the same orchestration as /v1/chat/completions runs behind it.

On success, actual token usage is settled with ZeroClick and reported via the zc-usage response header.

post/zeroclick/v1/chat/completions

Headers

zc-request-idstring

Example:zcreq_1

ZeroClick request id, echoed in logs for correlation. Set by ZeroClick when it proxies the request.

zc-agent-idstring

Example:agt_1

Identifier of the buying agent. Used to partition logs/analytics by agent; becomes the synthesized caller identity.

Request body

modelstring required

Model id; routes the request via model metadata. Kebab-cased into a ZeroClick service slug for metering.

categoriesstring[]

Candidate labels for text-classification models. May also be supplied via a system-role message.

multilingualboolean

Forwarded to the IAB cloud inference API only when the resolved model supports it.

metadataobject

Task-specific options. For GLiNER models this carries usecase, schema, labels, threshold, mask, and replacement_char. For moderation, threshold; for signal-extract, max_keywords.

Example request

{
  "model": "LFM2.5-1.2B-Instruct"
}

Response

OpenAI Chat Completions response. Includes the zc-usage header settling actual usage with ZeroClick.

idstring

object'chat.completion'

createdinteger

modelstring