Classify
Deprecated. Use POST /v3/router/decisions and orq.router.decisions.create() for new integrations. This endpoint remains available for backward compatibility with the same request and response contract.
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, TypeSafejev-previewonly.
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; when retry is omitted, the gateway retries twice before moving to the next fallback. 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.
Authorizations
Body
The content to evaluate. A string, an object or an array. For TypeSafe models, reference images declared in assets by writing their reference string. Native OpenAI accepts messages and function/custom-tool history. User messages support input_text, input_image and input_json; images can use inline base64 data URLs or public HTTP(S) URLs. At most 128 images across state and question instructions. Shared text/image parts support explicit prompt_cache_breakpoint markers. File IDs, audio, item references and bare content parts are unsupported. Other objects and arrays are serialized as text.
Up to 10 fallback models in order. The gateway retries a model for matching error codes before trying the next model. Every model must support classification and satisfy access checks. Requests with images in state require native OpenAI image-capable fallbacks; requests with assets or box questions require TypeSafe fallbacks.
10Response
Returns one answer per question.