Skip to content
by Unity Nodes
Partner docsapi reference › decisions › post v1systemone

NEAR AI Cloud: Post v1systemone

Updated 13-11-2026

POST /v1/systemone

Parameters:

  • x-model-pub-key (header, string): Signing public key from the model attestation, used for plaintext routing.

Request body (application/json):

  • assets (object)
  • model (string, required)
  • questions (object, required)
  • state (required): Text or structured context accepted by the System One protocol. one of option 1: string option 2: object option 3: array

Responses: 200: Typed decisions. X-Generation-Id identifies the receipt at /v1/signature/{id}; Inference-Id identifies billing usage.

  • answers (object, required)
  • id (string): Optional upstream ID. Required by our self-hosted TEE signing contract. TypeSafe's hosted API omits it; the gateway exposes X-Generation-Id instead.
  • model (string, required)
  • usage (object, required)
    • input_tokens (integer, int32, required)
    • output_tokens (integer, int32, required) 400: Invalid request or model modality 401: Authentication required 421: Selected model signing key is unavailable 429: Rate or concurrency limit 502: Invalid provider response