Sage docs | Levanto

Sage also serves the SystemOne API, the request format Jev uses. If your code already calls Jev, change the base URL, the key and the model name.

Endpoint and key

Base URL: https://sage.levanto.ai

Method	Path	Purpose
POST	`/v1/systemone`	Answer named questions about one `state`
GET	`/v1/models`	List the model names you can send

Both endpoints need your Levanto key: Authorization: Bearer lv_live_.... Set model to levanto-sage-v1.3 or sage-latest. Other names, such as jev-latest, return 422.

Request

curl -s https://sage.levanto.ai/v1/systemone \
  -H "Authorization: Bearer $SAGE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "sage-latest",
  "state": { "subject": "Duplicate charge", "message": "I was charged twice. Please help." },
  "questions": {
    "billing": { "type": "noul", "instructions": "Is this message about billing?" },
    "tone": { "type": "choice", "criteria": { "angry": "Upset or hostile", "calm": "Neutral or polite" } },
    "urgency": { "type": "score", "criteria": ["Can wait", "This week", "Today"] }
  }
}'

Response

{
  "model": "levanto-sage-v1.3",
  "answers": {
    "billing": { "type": "noul", "noul": 0.97 },
    "tone": { "type": "choice", "choice": "calm", "confidence": 0.81,
              "probabilities": { "angry": 0.19, "calm": 0.81 } },
    "urgency": { "type": "score", "score": 1.28, "confidence": 0.56,
                 "legend": { "0": "Can wait", "1": "This week", "2": "Today" },
                 "probabilities": { "0": 0.08, "1": 0.56, "2": 0.36 } }
  },
  "usage": { "input_tokens": 412, "output_tokens": 3 }
}

noul is the probability of yes. Each probabilities map sums to 1, and confidence is its highest value.

What maps

SystemOne `type`	Sage kind	Limits
`noul`	Yes/No	`criteria.true` and `criteria.false` are optional
`choice`	Choice	2 to 120 options
`score`	Scale	2 to 26 levels, scored from 0

state can be text, a JSON object or a JSON array.

Differences

Every question gets an answer, never null. Set your own threshold, or use /decide to get null when Sage isn’t sure.
Sort, Tags, Images and Grounding are on /decide and /decide/batch only.
Reasoning is off by default. Add "reasoning": "auto" or "on" to the request body to turn it on.
Close choices can depend on option order: keep your criteria keys in a fixed order.

Pricing

Same key and per-token rates as /decide. usage shows what each call uses. See Pricing.

Overview

Decision kinds

Options

Reference

SystemOne API

Endpoint and key

Request

Response

What maps

Differences

Pricing

​Endpoint and key

​Request

​Response

​What maps

​Differences

​Pricing

Endpoint and key

Request

Response

What maps

Differences

Pricing