Decisions

Beta. Evaluate content against named questions and receive structured answers, probabilities, and usage costs. Send the content as state and define each entry in questions as:

  • noul: estimate the probability that a statement is true.
  • choice: select an option from a set.
  • score: rate the content on an ordered scale.
  • box: locate one target in an image and return its bounding box. Beta, TypeSafe jev-preview only.

Instructions and criteria accept strings or structured JSON. TypeSafe models also accept inline images through assets (beta).

Use a native decision model or a supported chat model. Configure ordered fallbacks, optional retry, timeout.call_timeout in milliseconds, and an exact-match cache. Each retry and fallback gets a fresh timeout; omit retry to move directly to the next fallback on timeout. The response identifies the model that answered.

Requires the classify API-key permission. PII plugins and guardrails are not applied. See the Decisions guide for supported models, probability interpretation, and refusals.

post/v3/router/decisions

Request

  • Base URL
    https://my.orq.ai
  • URL
    https://my.orq.ai/v3/router/decisions
  • Auth
    HTTP bearer

Request body

assetsobject

Beta, TypeSafe models only. Inline images keyed by a reference string. Write the reference in state, instructions or criteria wherever the image belongs; every asset must be referenced. Required for box questions.

fallback_on_codesinteger[] nullable

HTTP status codes that trigger fallback. Defaults to [408,429,500,502,503,504,529]. Each code must be unique and between 400 and 599.

metadataobject

Key-value metadata attached to the trace.

modelstring required

ID of a model that supports native or emulated classify, including openai/gpt-6-luna.

namestring

The name to display on the trace. If not specified, the default system name will be used.

prompt_cache_keystring

Native OpenAI only. Partitions reuse of shared input across requests.

questionsobject required

Typed questions keyed by an identifier of your choice. Each answer is returned under the same key. Native OpenAI accepts 1 to 400 questions.

Response

Returns one answer per question.

answersobject required

Answers keyed by the question identifiers from the request.

modelstring required

The requested ID of the model that answered. This can be a fallback model.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • warning

      removed the request property

    • warning

      removed the request property