Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Request-ID
string | null

Optional client request id (1-128 chars of [A-Za-z0-9._:-]); echoed in the X-Request-ID response header

Body

application/json
context
required

The text to decide on (1–8,000 characters), or an ordered list of 1–16 content parts; text parts are joined with newlines. Media parts (image, document, audio) reference uploaded assets. Every modality is input only: the answer is always the structured decision. Video is not supported.

Required string length: 1 - 8000
questions
object
required

Question id → question (1–16). Question ids (1–100 characters) are returned as keys of answers. Questions of different types can be mixed in one request.

model
string | null

Optional model id (see GET /v1/models); defaults to the current model.

Response

One answer per question, typed like its question (choice, noul, score). Request id in the X-Request-ID header.

Decision response. The request id is returned in the X-Request-ID header.

model
string
required
answers
object
required

Question id → answer, in request order.

usage
object
required