Jev Decision API

curl https://aireiter.com/api/v1/systemone \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev",
    "input": {
      "state": "The payment API timed out.",
      "questions": {
        "is_urgent": {
          "type": "noul",
          "instructions": "Does this need a person right now?"
        }
      }
    }
  }'

import os
import requests

response = requests.post(
    "https://aireiter.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "model": "jev",
        "input": {
            "state": "The payment API timed out.",
            "questions": {
                "is_urgent": {
                    "type": "noul",
                    "instructions": "Does this need a person right now?",
                }
            },
        },
    },
)
print(response.json()["result"]["result"]["answers"])

const response = await fetch("https://aireiter.com/api/v1/systemone", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "jev",
    input: {
      state: "The payment API timed out.",
      questions: {
        is_urgent: {
          type: "noul",
          instructions: "Does this need a person right now?",
        },
      },
    },
  }),
});

const data = await response.json();
console.log(data.result.result.answers);

{
  "result": {
    "state": "Completed",
    "result": {
      "model": "jev-1.14.0",
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.49
        }
      },
      "usage": {
        "input_tokens": 280,
        "output_tokens": 23
      }
    }
  },
  "success": true,
  "errors": [],
  "messages": []
}

POST

api

systemone

curl https://aireiter.com/api/v1/systemone \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev",
    "input": {
      "state": "The payment API timed out.",
      "questions": {
        "is_urgent": {
          "type": "noul",
          "instructions": "Does this need a person right now?"
        }
      }
    }
  }'

import os
import requests

response = requests.post(
    "https://aireiter.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "model": "jev",
        "input": {
            "state": "The payment API timed out.",
            "questions": {
                "is_urgent": {
                    "type": "noul",
                    "instructions": "Does this need a person right now?",
                }
            },
        },
    },
)
print(response.json()["result"]["result"]["answers"])

const response = await fetch("https://aireiter.com/api/v1/systemone", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "jev",
    input: {
      state: "The payment API timed out.",
      questions: {
        is_urgent: {
          type: "noul",
          instructions: "Does this need a person right now?",
        },
      },
    },
  }),
});

const data = await response.json();
console.log(data.result.result.answers);

{
  "result": {
    "state": "Completed",
    "result": {
      "model": "jev-1.14.0",
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.49
        }
      },
      "usage": {
        "input_tokens": 280,
        "output_tokens": 23
      }
    }
  },
  "success": true,
  "errors": [],
  "messages": []
}

Authorizations

string

required

API key, Bearer Token formatGet API Key:Visit the API Key management page to get your API Key

Authorization: Bearer YOUR_API_KEY

Body

string

required

Model name. Fixed value jev.The result.result.model in the response is the actual version number used upstream, such as jev-1.14.0. This field is returned by the upstream service; do not provide a version number in the request.

object

required

Judgment content. Contains state and questions, plus assets when images are included.

Show Field Descriptions

string | object | array

required

The material to be judged. It can be a single sentence, an object, or an array. Only include data necessary to complete the judgment; do not include sensitive information such as API keys or passwords.When including images, specify the image reference name in state, such as { "photo": "img-7f3a91" }, where the reference name corresponds to a key in assets.

object

Image table (Beta). The key is the reference name, and the value is the image object. Omit if not including images.Reference names are matched as plain text and can be written in any string within state, question instructions, or criteria. The model will see the image at that position. Choose reference names that will not collide with body text; using a UUID for each image is recommended. Each reference name must appear at least once in the request.

Show Image Object

string

Fixed as image, can be omitted.

string

required

Image format: png, jpg, or jpeg, lowercase.

string

required

Base64 encoding of the image file. Use the standard base64 alphabet, with = padding, no line breaks, and without the data: prefix.

object

required

Question table, cannot be empty. Key names are self-defined, and each question is an object.Each question must have type and instructions.

noul — True/false question. Returns noul, ranging from 0 to 1, indicating the probability of “true”. criteria is optional, structured as { "true": "what counts as true", "false": "what counts as false" }.
choice — Single-choice question. criteria is required and is an object of “option name → description”. The returned choice is the selected option name.
score — Scoring. criteria is required and is an ordered array of at least two items, from low to high. The returned score is a numeric value indicating which tier it falls into, with the first item being 0, and can be a decimal. For example, with three tiers, 1.99 indicates it almost falls into the third item.
box — Image localization (Beta). Must include images; does not accept criteria. Write what to look for and in which image in instructions, for example "the car in `photo`". Returns a rectangle bounding the target.

A single request can contain multiple noul, choice, score, and box questions simultaneously. Do not pass stream; this endpoint only returns a single complete JSON response.

Response

The response body is the raw JSON from upstream, which this endpoint returns without modification. The evaluation results are in result.result.answers.

boolean

Whether the request was successful

array

Error list. Empty array on success

array

Additional messages. Empty array when there are no messages

object

Upstream execution result

Show Field Descriptions

string

Execution status. Completed indicates completion

object

Model response

Show Field Descriptions

string

The actual upstream version used, such as jev-1.14.0

object

Results for each question. Keys match the question names in the request.

noul: { "type": "noul", "noul": 0.49 }. Values of 0.8 and above can be considered “yes”, 0.2 and below can be considered “no”, and values close to 0.5 indicate uncertainty.
choice: choice is the selected option name, probabilities are the probabilities for each option, and confidence is the confidence score.
score: score is the score, and legend maps tier indices back to the text you submitted.
box: box consists of four edges { "top", "bottom", "left", "right" }, ranging from 0 to 1 as proportions relative to the image height and width, with the origin at the top-left corner; confidence is the confidence score. When drawing bounding boxes, multiply each edge by the image’s pixel width and height.

object

Token usage

Show Field Descriptions

integer

Number of input tokens

integer

Number of output tokens

Usage Examples

curl https://aireiter.com/api/v1/systemone \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev",
    "input": {
      "state": "The payment API timed out.",
      "questions": {
        "is_urgent": {
          "type": "noul",
          "instructions": "Does this need a person right now?"
        }
      }
    }
  }'

import os
import requests

response = requests.post(
    "https://aireiter.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
        "model": "jev",
        "input": {
            "state": "The payment API timed out.",
            "questions": {
                "is_urgent": {
                    "type": "noul",
                    "instructions": "Does this need a person right now?",
                }
            },
        },
    },
)
print(response.json()["result"]["result"]["answers"])

const response = await fetch("https://aireiter.com/api/v1/systemone", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "jev",
    input: {
      state: "The payment API timed out.",
      questions: {
        is_urgent: {
          type: "noul",
          instructions: "Does this need a person right now?",
        },
      },
    },
  }),
});

const data = await response.json();
console.log(data.result.result.answers);

{
  "result": {
    "state": "Completed",
    "result": {
      "model": "jev-1.14.0",
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.49
        }
      },
      "usage": {
        "input_tokens": 280,
        "output_tokens": 23
      }
    }
  },
  "success": true,
  "errors": [],
  "messages": []
}

Multi-Question Example

choice and score can be included in the same request as noul.

{
  "model": "jev",
  "input": {
    "state": {
      "ticket": "Payment API intermittent timeout, database connection pool nearing exhaustion."
    },
    "questions": {
      "next_action": {
        "type": "choice",
        "instructions": "Select the safest next step",
        "criteria": {
          "rollback": "Roll back recent changes",
          "observe": "Continue observing and sampling logs"
        }
      },
      "risk": {
        "type": "score",
        "instructions": "Assess the risk of this incident",
        "criteria": ["Low", "Medium", "High", "Critical"]
      },
      "escalate": {
        "type": "noul",
        "instructions": "Whether manual escalation is required"
      }
    }
  }
}

图片与 Box 示例（Beta）

Images are placed in assets, and state points to them using a reference name; `photo` is used in questions to refer to this image. The following example asks both “whether there is a car in the image” and “where the car is”.

{
  "model": "jev",
  "input": {
    "state": { "photo": "img-7f3a91" },
    "assets": {
      "img-7f3a91": {
        "type": "image",
        "format": "jpg",
        "data_base64": "/9j/4AAQSkZJRg..."
      }
    },
    "questions": {
      "has_car": {
        "type": "noul",
        "instructions": "Is there a car in `photo`?"
      },
      "car": {
        "type": "box",
        "instructions": "the car in `photo`"
      }
    }
  }
}

The answers in the response:

{
  "has_car": { "type": "noul", "noul": 0.97 },
  "car": {
    "type": "box",
    "box": { "top": 0.24, "bottom": 0.81, "left": 0.15, "right": 0.74 },
    "confidence": 0.74
  }
}

Box questions always return a box, and there is no result such as “not found”; a box will still be provided even when there is no target in the image, only with lower confidence. When unsure whether the target exists, add a noul question in the same request as shown in the example above; ignore the box if noul is very low.

Image Requirements

Item	Limitations
Format	Static PNG or JPEG images; animated images are not supported. WebP, GIF, HEIC, etc., must be converted to PNG or JPEG first
Single Image Size	No more than 16 MiB after decoding
Width, Height	280 to 1568 pixels per side; an error will be returned directly if out of range, no automatic scaling
Request Body	No more than 32 MiB, including JSON and base64

Scale the long edge down to within 1568 pixels before sending. Upstream will strip EXIF data and will not rotate according to EXIF orientation; please orient the pixels of phone photos properly beforehand.
Images will be converted into input tokens, counted towards usage.input_tokens, and also occupy the context window. An image of about 800 pixels is approximately 1500 tokens.
If any image in the request fails to meet the requirements, the entire request fails, and partial results will not be returned.

注意事项

This endpoint is not a chat endpoint and does not accept messages or stream.
Image input and Box questions are currently in Beta. Request formats, results, and limitations may change across versions, and they are not recommended for direct use in production decisions.
The context window is 32000 tokens.
When a business failure occurs, the HTTP status code may still be 200. Please check both success and errors. Authentication failure returns 401, a missing model or invalid JSON returns 400, and a non-existent model returns 404.

Overview

Image Series

Video Series

Audio Series

Text Series

Task Management

Authorizations

Body

Response

Usage Examples

Multi-Question Example

图片与 Box 示例（Beta）

Image Requirements

注意事项

​Authorizations

​Body

​Response

​Usage Examples

​Multi-Question Example

​图片与 Box 示例（Beta）

​Image Requirements

​注意事项

Authorizations

Body

Response

Usage Examples

Multi-Question Example

图片与 Box 示例（Beta）

Image Requirements

注意事项