JEV 1.13
Typed yes/no, choice and score answers about a state you send.
Capabilities
Send a state and a set of typed questions and get one typed answer per question. A noul question takes a true/false description pair and returns a value between 0 and 1. A choice question takes an object of label to description and picks one label, with a probability for each. A score question takes an array of level descriptions from low to high and returns a weighted score over those levels. Calls are synchronous; streaming is not supported. TypeSafe SDK users can keep their code: set the SDK base URL to https://api.dev.pika.art and its POST /v1/systemone calls work unchanged. Output tokens are free.
Authentication
api key header
The Pika API uses API keys to authenticate requests. Send your key in the X-API-Key header. Your API key is a secret. Don't expose it in browsers or other client-side code. Instead, call the API from your server. The signed-in playground uses a portal session and never sends your API key.
X-API-Key: YOUR_API_KEY
Endpoint
synchronous
Request
POST /v1/decisions
Request
curl -X POST https://api.dev.pika.art/v1/decisions \-H "X-API-Key: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model": "typesafe/jev-1.13","state": {"customer_tier": "enterprise","ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."},"questions": {"is_bug": {"type": "noul","instructions": "Is the customer reporting a software defect?","criteria": {"true": "The customer describes broken or unexpected product behavior.","false": "The customer is asking a question or requesting a feature."}},"team": {"type": "choice","instructions": "Which team should own this ticket?","criteria": {"account": "Login, permissions, or profile issues.","frontend": "Rendering, layout, or browser compatibility issues.","payments": "Checkout, billing, or payment processing issues."}},"urgency": {"type": "score","instructions": "How urgent is this ticket?","criteria": ["Can wait for the next release","Should be fixed this week","Blocking revenue right now"]}}}'
Response
{"id": "gen-dec-...","model": "typesafe/jev-1.13-20260917","provider": "TypeSafe","answers": {"is_bug": {"type": "noul","noul": 0.96},"team": {"type": "choice","choice": "payments","confidence": 0.75,"probabilities": {"account": 0,"frontend": 0.16,"payments": 0.84}},"urgency": {"type": "score","score": 1.99,"confidence": 0.99,"legend": {"0": "Can wait for the next release","1": "Should be fixed this week","2": "Blocking revenue right now"},"probabilities": {"0": 0,"1": 0.01,"2": 0.99}}},"usage": {"input_tokens": 476,"output_tokens": 70,"cost": 0.000019992}}
Errors
shared across calls
Errors use conventional HTTP status codes with a JSON body of the shape {"message": "..."}. A missing or invalid key returns 401.