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. Runs typed classification questions (noul, choice, score) against a native classify provider, including OpenAI Decisions with openai/gpt-6-luna, or a chat model that supports classify emulation. Emulated models answer through one structured-output call and their probabilities are model-reported rather than calibrated. Native providers can return refusal for individual questions; refused answers contain only type. The request and response follow the TypeSafe classification contract; model in the response identifies the primary or fallback model that answered and usage carries the computed cost like the Responses API. Both /v3/router/classify and /v3/router/decisions use this contract, including ordered fallbacks, request-level retry, and identity attribution. Both require classify.execute. This endpoint currently does not apply PII plugins or guardrails.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
ID of a model that supports native or emulated classify, including openai/gpt-6-luna.
Typed questions keyed by an identifier of your choice. Each answer is returned under the same key.
The content to evaluate. A string, an object or an array. For OpenAI GPT-6 Luna, strings are passed as text and objects or ordinary JSON arrays are serialized as text. User-message arrays accept string content or input_text/input_image parts. Images must be inline base64 data URLs, with at most 128 images across the request. Remote image URLs, file IDs, audio, non-user roles, bare content parts and tool items are rejected.
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. Image requests require native OpenAI image-capable fallbacks.
10The identity to attach to the trace.
Key-value metadata attached to the trace.
The name to display on the trace. If not specified, the default system name will be used.
Retry configuration for the request.
Response
Returns one answer per question.
Answers keyed by the question identifiers from the request.
The requested ID of the model that answered. This can be a fallback model.
The usage information for the request.
OpenTelemetry trace and span identifiers for this request.