Skip to content
Docs navigation: Docs

System Zero

Get an API key

DocsSystem Zero Updated

System Zero answers named questions about text with structured decisions and probabilities.

decide.ts
// Set SYSTEM_ZERO_API_KEY to your API key before running this example.
// Run this example on your server.
// SDK defaults: The default is 5 retries, also the maximum, with 150 seconds
// per attempt and a 60-second total retry budget. A single wait longer than 60
// seconds raises the last error.
// Use Retry-After-Ms, or Retry-After when milliseconds are absent. The wait is
// never shorter than a random backoff floor: a random fraction of 0.5 seconds
// doubled for each attempt, capped at 8 seconds.
import { SystemZeroClient } from '@rightnowai/system-zero';

const client = new SystemZeroClient({
  apiKey: process.env.SYSTEM_ZERO_API_KEY,
  baseUrl: "https://api.rightnowai.co/v1",
});
const reply = await client.decide({
  "model": "system-zero",
  "state": "The blender I ordered arrived with a cracked jar.",
  "questions": {
    "damaged": {
      "type": "boolean",
      "instructions": "Did the item arrive damaged?"
    }
  }
});
console.log(JSON.stringify(reply, null, 2));
const models = await client.models.list();
console.log(models);

System Zero processes the state and questions to answer the request. An Idempotency-Key allows a stored answer to be replayed when available. Read the data handling and training terms.

At a glance

Endpoint
POST https://api.rightnowai.co/v1/system-zero/decide
Key
Authorization: Bearer $SYSTEM_ZERO_API_KEY
Model
system-zero
State
Text, a JSON object or a JSON array.
Questions
boolean, choice and score.
Model discovery
Use a key with GET /v1/models to read attested models and their limits.

Inline input: text, image, audio; video attachments are held; only listed formats are available. See Inputs for input formats and availability.

Start here

For AI coding agents

Read the docs index or add the integration skill.