StateSet API Docs

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

{
  "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
  ]
}

POST

api

nsr

infer

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

{
  "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 '&#123;'inputs': [&#123;'type': 'text', 'value': 'walk twice'&#125;]&#125;'

Perform inference with the NSR Machine. Required scope: write

Request body

NSRInferRequest

GroundedInputRequest[]

required

Input sequence for inference

string

Optional session ID for context persistence

Response

NSRInferResponse

number (double)

required

Confidence score (0.0 to 1.0)

number (double)

Confidence for the interpreted output (0.0 to 1.0)

object

Show interpreted_output

string

required

string

Short rationale for how the interpreted output was chosen

object

Show output

string

required

integer (int64)

required

Processing time in milliseconds

SymbolDistributionResponse[]

Symbol distributions for each input

Show SymbolDistributionResponse

number (double)

required

Log probability of the argmax

integer (int64)

required

Symbol ID with highest probability

object[][]

required

Top-k symbols with their probabilities

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 --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/nsr/infer' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": [
    {
      "type": "text",
      "value": "walk twice"
    }
  ],
  "session_id": null
}'

{
  "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
  ]
}

​Request body

​Response

​Status codes

Request body

Response

Status codes