Jev Docs

Endpoint

Send POST /api/v1/decisions on this host. There is no chat-completions path and no streaming response. GET /api/v1/models lists the model id.

POST https://jev-api.org/api/v1/decisions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Authentication

Put your dashboard key in Authorization: Bearer. A missing or rejected key returns 401. The playground creates a key for the signed-in account when you run a request.

Request body

model is jev-1.13 or jev-latest. state is a string, object, or array of text, up to 60000 characters. questions is a map of 1 to 6 snake_case ids. The id is only the label your answer comes back under. Write the real question in instructions.

{
  "model": "jev-1.13",
  "state": "Checkout is blank after Pay.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout or billing.",
        "frontend": "Rendering or layout."
      }
    }
  }
}

Question types

Noul

type noul needs only instructions. The answer field noul is a probability from 0 to 1 that the statement is true. There is no separate confidence field.

Choice

type choice needs instructions and criteria, an object of 2 to 8 snake_case option ids mapped to short descriptions. The answer includes choice, probabilities for every option, and confidence.

Score

type score needs instructions and criteria as an ordered array of 2 to 10 level descriptions, lowest first. The answer includes score, a legend of your levels, probabilities, and confidence.

Response

A successful body has model, answers keyed by your question ids, usage.input_tokens, usage.output_tokens, and credits_used. The model field reports jev-1.13 even if you sent jev-latest.

Errors

• 401 — missing or rejected API key.
• 402 — the key is valid and the balance cannot cover this call. A failed upstream call does not use a credit.
• 422 — the body failed validation. The message names the field.
• 429 — the decision service is rate limited. Retry later.
• 502 — the decision service did not return answers. No credit is used.