Skip to content
aityx
Esc
↑↓navigate↵open⌘Jpreview
On this page

Introduction

Get choices, calculated amounts and dates from one decision API.

aityx is a decision API for AI applications. Return choices, calculated amounts and dates your application can use directly.

For example, a subscription cancellation returns cancel + refund, a $20 refund and an October 28 processing deadline. Your application supplies the customer message and account facts; aityx returns the answers together.

One endpoint, three shapes

POST /v1/systemone is the only public operation. What you include decides what runs:

You want to Send Shape
Execute a Decision with matching facts decision + state Decision only
Ask Jev questions about your data questions + state Jev only
Read evidence with Jev, then apply your rules decision + questions + state Jev + Decision

In the combined shape, Jev runs first and the Decision returns the consolidated result. There is no separate authoring or input-interpretation endpoint: you write the Decision JSON and send it with each case. See One endpoint, three shapes and Using Jev with aityx.

One endpoint, three shapes: POST /v1/systemone runs a Decision alone, Jev questions alone, or Jev questions feeding a Decision. Each shape returns answers with a receipt.One endpoint, three shapes: POST /v1/systemone runs a Decision alone, Jev questions alone, or Jev questions feeding a Decision. Each shape returns answers with a receipt.
Every shape returns answers and a receipt from the same endpoint.

One model. One state. Typed answers.

A native model is the JSON definition itself: name, inputs, decisions, and optional types and functions. Send it with state, the data for this case. Answer names and types come from the model; you do not repeat them in questions.

Selected answers from the recorded refund example, shortened for readability:

{
  "request_type": "cancel_refund",
  "refund_eligible": 1,
  "refund_amount": 20,
  "processing_deadline": "2026-10-28"
}

The example prorates a $60 plan over 30 days with 10 days unused, and adds seven calendar days to October 21. Boolean decisions return noul: 1 for true and 0 for false. The response also includes helper decisions, a receipt and token usage. Settled charges are available in the console.

Every shape costs $0.042 per 1M input tokens, with output free. See Pricing and limits.

Use it from your application

Keep the model in your application and send it with each case. Receipts return inline; retain them with the original state when needed. There is no stored-model or receipt-history lookup. aityx returns the decision; your application performs any refund or other action.

Was this page helpful?