models

Inception: Mercury Decide

Markdown · JSON

Inception: Mercury Decide

Mercury Decide evaluates shared text or JSON evidence against named questions and returns typed choices, yes/no probabilities or fractional rubric scores. Inception documents a dedicated decision workflow with up to 255 Choice options and ten Score levels.

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Mercury Decide is Inception’s model for structured decisions over supplied evidence. It combines a shared state with named questions and returns typed answers with probabilities. The result can be a selected category, an estimated yes/no probability or a position on a defined scale. This profile serves a bounded decision that software can interpret; its documented interface does not generate a free-form chat answer.

Shared state and meaningful question names

The producer’s request contains a model, a state and a non-empty map of questions. The question names are preserved in the answer map. Supply the information needed to judge each question, and name the questions around the results the workflow uses, such as category, priority or needs_follow_up. Several questions evaluate the same evidence independently. Their placement in one request does not make a later question depend on an earlier answer.

Inception’s example uses a JSON object for the state. The guide also permits strings, objects or arrays in the state, instructions and criterion descriptions, with instructions optional or null. Preserve useful structure when the evidence already consists of fields, and keep a document or message identifiable when supplying text. For a support case, include the actual request and relevant facts instead of a request to infer missing context.

Noul: an estimated positive answer

A noul question represents a yes/no condition. Its output is a probability from 0 to 1 that the positive answer applies. Optional true and false descriptions can specify what counts on each side of the question. For example, ask whether a message explicitly requests a replacement and distinguish that from a general complaint about the item. The probability supplies a numerical judgment; the application chooses the threshold and the resulting workflow action.

Keep the condition narrow enough that the evidence can settle it. If one question mixes whether the user wants help, whether an item is defective and whether the case is urgent, separate those conditions. Retain the returned probability with the question definition so a later reviewer can tell what the number actually measures.

Choice: selecting one named option

A Choice question uses a map of one to 255 option names and descriptions; descriptions can be null. The returned choice is the highest-probability supplied option. The result also contains a probability for every option and confidence. Define distinct meanings for categories, and include a fallback category when some inputs will lie outside the specific options. Short output keys can identify categories while fuller descriptions establish the boundaries between them.

A routing brief might distinguish an access issue, a product question and a reported defect. State the meaning of each option and provide the message that needs routing. The output is a selected category with a distribution, not an instruction that has already changed a queue or contacted another system. Examine competing probabilities when a case is ambiguous rather than interpreting the winning label as proof of certainty.

Score: an expected position on a rubric

A Score question uses an ordered array of one to ten level descriptions, starting at level 0. Its score is the probability-weighted average of the level indices and can fall between levels. The answer contains the legend, per-level probabilities and confidence. Define the order and the criteria for each level, such as no immediate impact, an issue with a workable alternative, and a fully blocked task.

A fractional expected score is useful for prioritization or aggregation. It is different from choosing the single most likely level. Keep the legend with the number so that a score is not interpreted on an unrelated scale. Confidence for Choice and Score is separately reported between 0 and 1; the relevant guide does not define it as identical to the largest option probability or supply a universal formula to reconstruct it.

Preparing a useful decision result

One piece of evidence can support independent category, urgency and condition questions. A document-review task can ask whether a required topic is present, choose its category and rate its relevance on described levels. Use only source material available in the state, with criteria tied to the decision the workflow needs next. If an action requires an earlier result, make that result explicit in the evidence for the next step instead of assuming the questions form a hidden sequence.

The response returns the model name and an answers map keyed by the supplied question names. Choice probabilities use the option names; Score probabilities use string indices with the legend explaining those indices. Keep the state identifier, question definitions and typed answers associated. This produces an interpretable classification or rating artifact rather than a number detached from the facts that generated it.

Interface scope and limits

Inception documents Mercury Decide through its dedicated decision interface. It does not support the maker’s chat-completion, streaming or tool-calling interfaces, so capabilities from Mercury’s reasoning, voice and code-generation profiles should not be transferred to this model. The decision guide specifies the option and level counts but gives no numerical state-token limit or question-count ceiling; keep shared evidence focused on the questions being evaluated.

Assess probabilities and category boundaries on representative labeled material from the intended task. Review borderline answers against the state and preserve missing information rather than replacing it with invented facts. A useful Mercury Decide result gives a closed decision, its probabilities and the definitions needed to understand it; the surrounding application determines how that result becomes routing, prioritization or a review outcome.

Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide

inception/mercury-decide

Inception /inception/mercury-decide

Overview

Mercury Decide evaluates shared text or JSON evidence against named questions and returns typed choices, yes/no probabilities or fractional rubric scores. Inception documents a dedicated decision workflow with up to 255 Choice options and ten Score levels.

Accepted inputs
Text
Results
decisions

Available in Ailoot · inputs & methods

Ailoot Ultra · System One POST /v1/systemone
Input types
text
Output types
decisions
Output format
json
FieldTypeRequirementValues & limitsDefault
FieldmodelTypestringRequirementRequiredValues & limits
inception/mercury-decide
Default—
FieldproviderTypeschemaRequirementOptionalValues & limitsDefault—
FieldquestionsTypeobjectRequirementRequiredValues & limitsDefault—
Fieldsession_idTypestringRequirementOptionalValues & limitsDefault—
FieldstateTypeschemaRequirementRequiredValues & limitsDefault—
FieldtraceTypeschemaRequirementOptionalValues & limitsDefault—
FielduserTypestringRequirementOptionalValues & limitsDefault—
Fieldquestions.<id>.typeTypestringRequirementRequiredValues & limits
noul, choice, score
Default—
Fieldquestions.<id>.instructionsTypestring|object|arrayRequirementRequiredValues & limitsDefault—
Fieldquestions.<id>.criteriaTypeobject|arrayRequirementOptionalValues & limits
Conditions: choice/score: required; noul: optional. choice criteria is object; score is array with minItems1.
Default—
Fieldquestions.<id>.criteria.trueTypestring|object|arrayRequirementRequiredValues & limits
Applies when: noul criteria object supplied
Default—
Fieldquestions.<id>.criteria.falseTypestring|object|arrayRequirementRequiredValues & limits
Applies when: noul criteria object supplied
Default—
Input material combinations

noul · Required: state, questions.<id>.type=noul, questions.<id>.instructions

choice · Required: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object

score · Required: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1

Method parameters and lifecycle
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, state, questions
Parametermaterial_typesContracttext
Parameteroptional_controlsContractprovider, session_id, trace, user
Parametermultimodal_input_bindingContractnull

Lifecycle: synchronous

Send the exact model ID and retain the complete native response.

Pricing

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode
Not specified When fast mode is selected
Flex mode
Not specified When flex mode is selected
Maximum reasoning effort
Not specified When maximum reasoning effort uses the default adjustment

Ailoot rates

Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

ConfigurationRate scheduleContext tokens, more thanContext tokens, up to and includingCharge
ConfigurationBase token ratesRate scheduleBase rateContext tokens, more than—Context tokens, up to and includingNo upper boundCharge
Input · Input tokens $0.00008 / 1K tokens
Output · Output tokens $0 / 1K tokens
Input · Cache read $0 / 1K tokens
Input · Cache write — / 1K tokens
Input · Cache write, 1 hour — / 1K tokens
ConfigurationRequest-length tier 1Rate schedule—Context tokens, more than0Context tokens, up to and includingNo upper boundCharge
Input · Input tokens $0.00008 / 1K tokens
Output · Output tokens $0 / 1K tokens
Input · Cache read $0 / 1K tokens
Input · Cache write — / 1K tokens
Input · Cache write, 1 hour — / 1K tokens

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →

Example requests

Ailoot Ultra · System One

Retained official request structure; documentary exampleUse your actual request material and retain the complete result
{
  "model": "inception/mercury-decide",
  "questions": {
    "is_bug": {
      "criteria": {
        "false": "The customer is asking a question or requesting a feature.",
        "true": "The customer describes broken or unexpected product behavior."
      },
      "instructions": "Is the customer reporting a software defect?",
      "type": "noul"
    },
    "team": {
      "criteria": {
        "account": "Login, permissions, or profile issues.",
        "frontend": "Rendering, layout, or browser compatibility issues.",
        "payments": "Checkout, billing, or payment processing issues."
      },
      "instructions": "Which team should own this ticket?",
      "type": "choice"
    },
    "urgency": {
      "criteria": [
        "Can wait for the next release",
        "Should be fixed this week",
        "Blocking revenue right now"
      ],
      "instructions": "How urgent is this ticket?",
      "type": "score"
    }
  },
  "state": {
    "customer_tier": "enterprise",
    "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
  }
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='inception/mercury-decide'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT

Receive and save results

Ailoot Ultra · System One

json

Keep all completed results

Keep every complete returned response, file and content part.

Every supplied question-ID answer with its exact type, noul/choice/score value, confidence, probabilities and legend is retained. Entire original JSON is stored and returned only after settlement.

If the original response needs checking

Preserve original operation and full/partial reply; do not replay POST.

Response fields
FieldType
FieldmodelTypestring
FieldidTypestring
FieldproviderTypestring
Fieldanswers.<id>.typeTypestring
Fieldanswers.<id>.noulTypenumber
Fieldanswers.<id>.choiceTypestring
Fieldanswers.<id>.scoreTypenumber
Fieldanswers.<id>.confidenceTypenumber
Fieldanswers.<id>.probabilitiesTypeobject
Fieldanswers.<id>.legendTypeobject
Fieldusage.input_tokensTypeinteger
Fieldusage.output_tokensTypeinteger
Fieldusage.costTypenumber
Errors and next steps
ResponseConditionNext step
Response400 · invalid_request_errorConditionInvalid required field, representation or valueNext stepCorrect the indicated request field.

Aliases

Model aliases

Ailoot Ultra inception/mercury-decide

Method path aliases

Use the method paths shown above.

Related caller IDs

inception/mercury-decide

FAQ · Inception: Mercury Decide
What inputs and results are available?

POST /v1/systemone · inception/mercury-decide: text → decisions

Which fields does the request use?

POST /v1/systemone · inception/mercury-decide: model, provider, questions, session_id, state, trace, user

More details

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription
Choose a discounted plan for your regular requests.
Promo code: up to 50% off
Enter your code at checkout. The price updates to reflect the current promotion.
Spending in your history
The model, tokens and amount are recorded for each request.

Choose a subscription · View model prices

Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application
Add text, image, video and audio generation to paid features in your service.
Reseller licence
Send a description of your project and how you provide access. Request written terms for use and resale.
Documents on the website
The service offer, licence agreement and data processing policy are available before you connect.

Request a reseller licence · Service offer and licence agreement