API guide
How to use Jev: your first judgment call
How to use Jev for a first call: get a key, post one yes or no question, and read a probability. Unofficial notes for developers, not a trial key.
How to use Jev takes one request. This site is unofficial. It does not call Jev or hand out a trial key.
How to use Jev: get a key
How to use Jev starts in the TypeSafe console. The homepage meta description still says early access. I have not checked whether a new signup waits in a queue.
How to use Jev without that key: a third-party gateway that lists Jev says its own key is enough, and our Jev API guide names it. Vercel AI Gateway lists typesafe-ai/jev and typesafe-ai/jev-1.14.0. Keep the key in TYPESAFE_API_KEY.
How to use Jev for a first request
How to use Jev for a first request is one POST to https://api.typesafe.ai/v1/systemone. Send a Bearer key and Content-Type: application/json. The body has model, state, and questions. state is the text or object to judge. Name each question. The answer uses that name.
How to use Jev in this curl follows those fields. The state line is the System One double-charge sample, written from the documented fields, not a live call.
curl --request POST --url https://api.typesafe.ai/v1/systemone \ --header "Authorization: Bearer YOUR_KEY" \ --header "Content-Type: application/json" \ --data '{"model":"jev-1.14.0","state":"I was charged twice for my subscription this month. Please refund the extra charge.","questions":{"refund_requested":{"type":"noul","instructions":"Is the customer asking for a refund?"}}}'
How to use Jev from the answer: noul runs from 0 to 1. Near 1 is yes, near 0 is no, near 0.5 is a split. Their billing sample shows noul 0.98, 120 input tokens, and 12 output tokens, not this curl.
How to use Jev across four question types
How to use Jev for several checks at once: mix the types in one request. How to use Jev runs questions in parallel. How to use Jev still counts an added question as input tokens.
How to use Jev for a yes or no is a noul: the probability of yes, not a degree, with no separate confidence.
How to use Jev for a label is a choice: the top option, a probability per option, and confidence from 0 to 1. At most 255 options.
How to use Jev for a scale is a score. Levels run from low to high, two to 10. score can fall between levels.
How to use Jev for a spot in a picture is a box. It needs Jev 1.14, TypeSafe-Danger-Zone-Images: true, and a PNG or JPEG. Edges are fractions: top, bottom, left, right. The images page says this is not ready for production. How to use Jev on a box always returns edges, so add a noul asking if the target is there.
How to use Jev for a support inbox
How to use Jev for a support inbox puts the ticket in state. How to use Jev on a fuzzy ask: set criteria true for a clear refund ask, and criteria false for no refund ask. How to use Jev does not write the email.
How to use Jev with thresholds you can defend
How to use Jev here starts at 0.7 for yes and 0.3 for no, and the middle goes to a person. How to use Jev when a false yes is expensive: raise 0.7. How to use Jev on a box has no recommended threshold.
How to use Jev and what a call costs
How to use Jev is billed on input tokens: $0.042 per million for jev-1.14.0 and jev-1.13.0. Output is free. 10,000 requests at 500 input tokens is $0.21, calculated.
How to use Jev with tested prompts
How to use Jev from a blank page is optional. Packs: use cases. Judge pack: Jev as a judge. Each pack includes its agreement rate on public human-labeled data. First half free to read, second half paid.
FAQ
- How to use Jev if the console key is not in your hand yet? A third-party gateway that lists Jev says its own key is enough.
- How to use Jev when the noul sits near 0.5? Start at 0.7 for yes and 0.3 for no.
- How to use Jev on an image? Send PNG or JPEG with TypeSafe-Danger-Zone-Images: true.
- How to use Jev if you wanted a written explanation? Jev returns a typed value and probabilities, not chat text.
- How to use Jev past the default length? Send TypeSafe-Danger-Zone-Long-Context: true.
- How to use Jev if the ticket is not in English? Accuracy is worse than on English, including for CJK.
- How to use Jev when you need the rate cap? The Models page says to read it in the console. This page has no number for it.
Sources
2026-10-25