Create a decision (OpenAI format)

Preview. OpenAI's Decisions contract: ordered Predicate, Choice, and Score questions about one input, answered in the same order with probabilities. Use an OpenAI base URL of https://api.munito.ai/inference/v1 and call this path over HTTP. The models, rate limits, billing, and errors are those of Evaluate decisions, with OpenAI error envelopes. perplexity-ai/pplx-decider-v1.2 accepts up to 8 input_image parts whose image_url is a base64 data URL; an image link gets 400. blockbrain/cygnet is text only, and a request with an image gets 400.

POST
/decisions

Authorization

headerAuthorizationBearer <token>

Your Munito API key.

Header Parameters

munito-service-tier?string

priority, standard or flex. The response names the tier that is billed; see x-ratelimit-over-limit. See Service tiers.

Default"standard"
Value in"priority""standard""flex"

Request Body

application/json
  1. body
model*string

A decision model available to your account.

input*|array<>

A string, or user messages whose content is a string or input_text and input_image parts. Images go to perplexity-ai/pplx-decider-v1.2 only.

questions*array<>

1 to 64 questions, in answer order.

safety_identifier?string

Up to 128 characters. Accepted and not used.

Response Body

Answers in question order. A predicate returns its probability. A choice returns the chosen value, its confidence, and the probability of each value. A score returns the expected level, its confidence, and the probability of each level.

application/json
curl -X POST 'https://api.munito.ai/inference/v1/decisions' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "perplexity-ai/pplx-decider-v1.2",
  "input": "The parcel arrived with a crushed corner and the mug inside is broken.",
  "questions": [
    {
      "type": "predicate",
      "instructions": "Is the item damaged?"
    },
    {
      "type": "choice",
      "instructions": "What should we offer?",
      "choices": [
        {
          "value": "refund"
        },
        {
          "value": "replacement"
        }
      ]
    }
  ]
}'
{
  "model": "perplexity-ai/pplx-decider-v1.2",
  "answers": [
    {
      "type": "predicate",
      "name": null,
      "probability": 0.99
    },
    {
      "type": "choice",
      "name": null,
      "choice": "replacement",
      "confidence": 0.21,
      "probabilities": [
        {
          "value": "refund",
          "probability": 0.39
        },
        {
          "value": "replacement",
          "probability": 0.61
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 138,
    "output_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_write_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 138
  }
}