# Jev API

> Hosted API for Jev, TypeSafe AI's System One model. Send a state and typed questions to one endpoint; get back Noul (yes/no probability), Choice (one option plus a probability for every option), or Score (a position on your scale). This site is an independent API service, not TypeSafe's own console.

## Docs

- [Jev API Docs](https://jev-api.org/docs): endpoint, authentication, request body, question types, response, limits, errors, differences from TypeSafe's API
- [Quickstart](https://jev-api.org/docs#quickstart): cURL, JavaScript, and Python examples
- [Pricing](https://jev-api.org/pricing): credit plans; 1 credit per successful call

## API contract

- Endpoint: POST https://jev-api.org/api/v1/decisions
- Auth: Authorization: Bearer <key>. Create keys at https://jev-api.org/dashboard/api-keys. Keep the key server-side.
- Models: GET https://jev-api.org/api/v1/models. Send model "jev-1.13" ("jev-latest" is an alias). Versioned ids such as "jev-1.13.0" return 422.
- Body: { "model", "state", "questions" }
  - state: string, JSON object, or array of text; up to 60,000 characters
  - questions: map of 1 to 6 lowercase snake_case ids; the id is only a label, the question goes in "instructions" (text, 1 to 2,000 characters)
- noul: needs "instructions". Answer: { "type": "noul", "noul": <0..1> }
- choice: needs "instructions" and "criteria", an object of 2 to 8 snake_case option ids mapped to descriptions (up to 300 characters). Answer: "choice", "probabilities" for every option, "confidence"
- score: needs "instructions" and "criteria", an array of 2 to 10 level descriptions, lowest first. Answer: "score", "legend", "probabilities", "confidence"
- Response: { "model": "jev-1.13", "answers": { ...keyed by your ids }, "usage": { "input_tokens", "output_tokens" }, "credits_used": 1 }
- Errors: 401 missing or rejected key; 402 not enough credits; 422 invalid body (the message names the field); 429 rate limited, retry later; 502 upstream returned no answers (no credit used)
- Billing: 1 credit per successful call, whatever the number of questions; validation errors and upstream failures are free. New accounts get 2 credits.
- No streaming and no chat-completions path.

## Example

POST https://jev-api.org/api/v1/decisions
{"model":"jev-1.13","state":"I was charged twice for my subscription.","questions":{"refund":{"type":"noul","instructions":"Is the customer asking for money back?"}}}

## Optional

- [Home](https://jev-api.org/): examples, limits, FAQ
- [TypeSafe AI](https://typesafe.ai): the company that builds and serves Jev