Jev Judgment Model

Jev, by TypeSafe, is a judgment model, not a chat model. Give it a piece of text and a question and it answers directly: which category, what score, yes or no — in a form your program can use as-is. Typical uses: route a "charged twice" complaint to the billing team, score a review for satisfaction, or decide whether an email is asking for a refund.

Request Example

Classify a "charged twice" message into billing, technical or other. The model name is always Jev.

curl "https://apicdn.xyc.ai/v1/systemone" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Jev",
    "state": "I was charged twice for the same order.",
    "questions": {
      "department": {
        "type": "choice",
        "instructions": "Which team should handle this customer message?",
        "criteria": {
          "billing": "Charges, payments and refunds",
          "technical": "Bugs and integration issues",
          "other": "Other requests"
        }
      }
    }
  }'

Response

The message is routed to billing, with a probability for every option. answers.department.choice is the selected category, probabilities lists each option's probability, and confidence is the model's confidence in this judgment.

{
  "model": "Jev",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "probabilities": {"billing": 0.96, "technical": 0.01, "other": 0.03},
      "confidence": 0.92
    }
  },
  "usage": {"input_tokens": 339, "output_tokens": 38}
}

Three Judgment Types

state can be text, an object or an array. Every question name you define under questions comes back under answers; multiple questions are judged independently — one answer is never fed into the next.

Score Example

{
  "model": "Jev",
  "state": "It broke after three days and support was rude.",
  "questions": {
    "sentiment": {
      "type": "score",
      "instructions": "Rate the satisfaction of this review",
      "criteria": ["very unhappy", "unhappy", "neutral", "happy", "very happy"]
    }
  }
}
// answers.sentiment → {"type":"score","score":0.01,"legend":{"0":"very unhappy",...},"probabilities":{"0":0.99,...},"confidence":0.99}

Yes/No Example

{
  "model": "Jev",
  "state": "Hi, I want to cancel my subscription and get a refund.",
  "questions": {
    "is_refund": {"type": "noul", "instructions": "Is the customer asking for a refund?"}
  }
}
// answers.is_refund → {"type":"noul","noul":0.99}

Official SDK

The TypeSafe SDKs work unchanged: point base_url at the gateway, use your XycAi key, and set the model to Jev.

Python (pip install typesafe-sdk):

import os
from typesafe_sdk import Choice, TypeSafeClient

client = TypeSafeClient(
    api_key=os.environ["XYCAI_API_KEY"],
    base_url="https://apicdn.xyc.ai",
    model="Jev",
)
response = client.system_one(
    state="I was charged twice for the same order.",
    questions={
        "department": Choice(
            instructions="Which team should handle this customer message?",
            criteria={
                "billing": "Charges, payments and refunds",
                "technical": "Bugs and integration issues",
                "other": "Other requests",
            },
        ),
    },
)
print(response.answers["department"])

TypeScript (npm install @typesafe-ai/sdk):

import { choice, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient({
  apiKey: process.env.XYCAI_API_KEY,
  baseURL: "https://apicdn.xyc.ai",
});
const response = await client.systemOne({
  model: "Jev",
  state: "I was charged twice for the same order.",
  questions: {
    department: choice("Which team should handle this customer message?", {
      billing: "Charges, payments and refunds",
      technical: "Bugs and integration issues",
      other: "Other requests",
    }),
  },
});
console.log(response.answers.department);

Pricing and Limits

Billed on input tokens only; output is free. See the TypeSafe Enterprise price on the Model Square. state plus the longest single question must not exceed 32K tokens; state plus all questions combined must not exceed 64K tokens.

Troubleshooting

Full interface reference: TypeSafe API docs; complete syntax for the three types: TypeSafe primitives.