Pick one label from a set
jev_choiceRead-onlyIdempotent
Pick exactly one label from a defined set for routing, classification, or screening. Returns the selected label with calibrated confidence and optional per-label probabilities, with no side effects.
Instructions
Ask Jev to pick exactly one label from a defined set. Returns the selected label, the calibrated confidence in it, and — when asked — the probability of every label. Use it for routing, classification, and screening. Read-only: the request has no side effects.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Return the raw API result (every field, unformatted) instead of the compact answer set. | |
| model | No | Model override, e.g. jev-latest, or a pinned version such as jev-1.13.0. | |
| state | Yes | The material to judge: a string, a JSON object, or an array of text values. Jev reads this once and evaluates every question against it in parallel. Non-text inputs (images, audio, binaries) must be converted to text or structured fields first. | |
| options | Yes | Option labels mapped to a description of what each label means, or null to leave it undescribed. At least 2 labels. | |
| answer_name | No | Key this answer appears under in the response. Defaults to "answer". | |
| instructions | Yes | The question, as a string or structured JSON. Write it as a judgment a knowledgeable person makes in a second, not as a multi-step task. | |
| include_usage | No | Include token usage. Default true. | |
| include_legend | No | Include the score rubric legend echoed by the API. Off by default: you already sent the rubric. | |
| confidence_threshold | No | Answers below this confidence come back flagged (needs_review for choice/score, uncertain for noul). Default 0.6, or JEV_CONFIDENCE_THRESHOLD. | |
| include_probabilities | No | Include the full probability table per answer. Off by default — it is the largest part of a response. |