Models

Docs System Zero Models Updated 2026-10-15

Read the model list to choose the alias or an attested pinned version.

decide.sh

# Set SYSTEM_ZERO_API_KEY in your environment first.
if [ -z "$SYSTEM_ZERO_API_KEY" ]; then
  printf '%s\n' 'Set SYSTEM_ZERO_API_KEY before running this example.' >&2
  exit 1
fi

# Read the models available to your key.
if ! response=$(curl --silent --show-error --fail-with-body \
  'https://api.rightnowai.co/v1/models' \
  --header "Authorization: Bearer $SYSTEM_ZERO_API_KEY"); then
  printf '%s\n' "$response" >&2
  exit 1
fi

# Print the response without changing its fields.
printf '%s\n' "$response"

Choose a model

GET /v1/models requires a System Zero API key. The response places the alias first, followed by attested versions.

system-zero: The alias for the attested model version.
system-zero-1.0.0: The pinned version named by the reviewed production release.

Use an ID from the list as the model in a decide request. See Versions for choosing between an alias and a pin.

Model fields

The response has object: "list" and a data array. Each model entry contains these fields.

id: The alias or pinned model ID.
object: model
alias_for: The model version named by the alias.
released_at: The stated release date, or null.
calibration_versions: The stated calibration set, or null.
limits: Limits reported by the gateway.
held_routes: Features that the deployment does not serve.

A null release date or calibration set means that metadata has not been stated. Do not infer it from the model ID or an example answer.

Limits and availability

Read limits for the model's reported boundaries and held_routes for unavailable features. A media-shaped field in a limits object does not make media available.

The launch serves standard text decisions. Image, audio, document and video input, long context, long recordings, committee routing and deliberate mode remain held.

Discovery failures

An unsupported model returns 404 model_not_found. Choose the alias or a pinned version returned by the model list.

Model discovery returns 503 service_unavailable when no serving version is attested. Follow the response's retry advice.