Perform inference using the NSR Machine

Processes input sequences through the neural-symbolic reasoning pipeline, combining perception, parsing, and semantic computation to produce outputs…

POST /api/v1/nsr/infer

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/infer' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": [
    {
      "type": "text",
      "value": "walk twice"
    }
  ],
  "session_id": null
}'

200

{
  "confidence": 0.95,
  "output": {
    "type": "list",
    "value": [
      {
        "type": "string",
        "value": "WALK"
      },
      {
        "type": "string",
        "value": "WALK"
      }
    ]
  },
  "processing_time_ms": 12,
  "symbol_distributions": null,
  "symbols": [
    1,
    3,
    1
  ]
}

Processes input sequences through the neural-symbolic reasoning pipeline, combining perception, parsing, and semantic computation to produce outputs. Input Types

• text: Natural language or symbolic commands (e.g., ‘walk twice’)
• number: Numeric values for mathematical operations
• embedding: Pre-computed vector embeddings
• image: Raw pixel data for visual inputs
• composite: Numeric grounded symbol vectors such as emulator UI-node fields Example

curl -X POST 'https://api.nsr.stateset.com/api/v1/nsr/infer' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '{'inputs': [{'type': 'text', 'value': 'walk twice'}]}'

Perform inference with the NSR Machine.

Required scope: write

Request body

NSRInferRequest

inputs · GroundedInputRequest[] · required

Input sequence for inference

session_id · string

Optional session ID for context persistence

Response

NSRInferResponse

confidence · number (double) · required

Confidence score (0.0 to 1.0)

interpreted_confidence · number (double)

Confidence for the interpreted output (0.0 to 1.0)

interpreted_output · object

Show interpreted_output

type · string · required

interpreted_rationale · string

Short rationale for how the interpreted output was chosen

output · object

Show output

type · string · required

processing_time_ms · integer (int64) · required

Processing time in milliseconds

symbol_distributions · SymbolDistributionResponse[]

Symbol distributions for each input

Show SymbolDistributionResponse

argmax_log_prob · number (double) · required

Log probability of the argmax

argmax_symbol · integer (int64) · required

Symbol ID with highest probability

top_k · object[][] · required

Top-k symbols with their probabilities

symbols · integer (int64)[] · required

Symbol sequence identified

Status codes

Code	Meaning
200	Inference successful
400	Invalid request - empty inputs or validation failed
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset
500	Internal server error - inference engine failure
504	Reasoning budget exhausted before completion

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/infer' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": [
    {
      "type": "text",
      "value": "walk twice"
    }
  ],
  "session_id": null
}'

200

{
  "confidence": 0.95,
  "output": {
    "type": "list",
    "value": [
      {
        "type": "string",
        "value": "WALK"
      },
      {
        "type": "string",
        "value": "WALK"
      }
    ]
  },
  "processing_time_ms": 12,
  "symbol_distributions": null,
  "symbols": [
    1,
    3,
    1
  ]
}