Getting started with TypeSafe Jev
Jev is TypeSafe’s System One model: unstructured state in, typed probabilistic decisions out. This page gets you to one successful evaluation without selling you a key. Official onboarding is the quick start. jev.pro is independent and unofficial.
1. Pick a door (do not mix ids)
Use the channel matrix (refreshed here as of 2026-09-21):
| If you have… | Call… | Send model… |
|---|---|---|
| TypeSafe console key | POST https://api.typesafe.ai/v1/systemone or official SDK |
jev-latest (or pin jev-1.13.0) |
| Vercel / AI Gateway | experimental_evaluate |
typesafe-ai/jev |
| OpenRouter credit | Decisions API, not chat completions | typesafe/jev-1.13 |
| Cloudflare Worker binding | env.AI.run |
typesafe/jev |
No console yet? How to get access — waitlist on typesafe.ai. This site cannot expedite it.
2. Smallest first-party request
export TYPESAFE_API_KEY=... # from the TypeSafe dashboard, never from jev.pro
curl -X POST https://api.typesafe.ai/v1/systemone \
-H "Authorization: Bearer $TYPESAFE_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<'EOF'
{
"state": "Hi, I've been trying to connect my Stripe account for 3 days. Please help ASAP.",
"model": "jev-latest",
"questions": {
"urgency": {
"type": "noul",
"instructions": "Does this message express urgency?"
}
}
}
EOF
You should see a resolved "model": "jev-1.13.0" (example from TypeSafe’s quick start) and answers.urgency.noul. Then add Choice department and Score frustration on the same body — official docs: questions run in parallel.
Python: pip install typesafe-sdk then TypeSafeClient() (Python ≥ 3.10). JS: npm i @typesafe-ai/sdk (Node 20+). Both read TYPESAFE_API_KEY and default to jev-latest.
3. Pin before you tune
Aliases move. TypeSafe tells you to pin jev-1.13.0 once confidence floors are fitted. Log usage.input_tokens and the full probabilities map.
Vendor price claim: $0.042 / million input tokens; output free — confirm on the models page. Rate limits on that page are described as dynamic.
4. If it fails
| Symptom | First fix |
|---|---|
| 401 | Wrong or missing bearer for that door |
| 422 | Missing model / state / questions, or bad criteria |
| 429 / 529 | Back off (SDKs do this) |
| 402 / “customer verification” | Marketplace billing or Vercel account — not in TypeSafe’s API error table |
| Unknown model | You sent jev-1.13 to first-party or jev-latest to OpenRouter |
See the error tree.
FAQ
Playground first? Yes — quick start step 1 is paste state, add a Noul, then mix types.
Agent skill? Install TypeSafe’s skill so coding agents batch questions. It still needs your key.
Free tier? Not described on the public models page we cited. Do not invent credits.
Hub: Access. Siblings: channels compared, first API call. Official: docs.typesafe.ai.
Sources
Public TypeSafe or adjacent documentation only. No private claims.