llamajev /v1/systemone

TypeSafe Jev-compatible structured-decision API served by an unmodified llama-server.

Authentication

All /v1/* endpoints require the API key as a Bearer token:

Authorization: Bearer <your-api-key>

Missing or wrong key → 401. /health, this page, and the docs below are public.

Endpoints

EndpointMethodAuthPurpose
/v1/systemonePOSTyesEvaluate a batch of typed questions (noul / choice / score) against a conversation or image, returning per-option probabilities
/v1/modelsGETyesAccepted model IDs
/v1/limitsGETyesRequest limits (questions, answers, body, context, concurrency)
/healthGETnoReadiness + backend/model info
/health/liveGETnoLiveness probe

Example

curl https://system1.mckeown.in/v1/systemone \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your-api-key>' \
  -d '{
    "model": "jev-latest",
    "state": [{"role": "user", "content": "I was charged twice. Please refund the duplicate."}],
    "questions": {
      "refund":     {"type": "noul",   "instructions": "Does the user request a refund?"},
      "department": {"type": "choice", "instructions": "Which team?",
                     "criteria": {"billing": "Payments and refunds", "technical": "Software bugs"}},
      "urgency":    {"type": "score",  "instructions": "How urgent?",
                     "criteria": ["Routine", "Urgent", "Emergency"]}
    }
  }'

Response shape

One entry per question: noul questions return {"noul": p}; choice returns the picked label plus a full probabilities map and confidence; score returns a continuous score, a legend, and per-bucket probabilities. Use model: "jev-latest" for state; image content is accepted as {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}} parts.

Interactive docs

Swagger UI → · OpenAPI JSON → · ReDoc →