Query an Input
Query an individual Input
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the Input to query. The Input must be uploaded and in a valid state for queries.
Body
The question to ask about the input content. Required when use_preset is false.
10000The perception model to use.
perception-0-fast, perception-0-thinking The type of the query. Synchronous queries block and return results in response. perception-0-thinking requires asynchronous.
synchronous, asynchronous Skips using pre-processing enhancements for queries. Increases latency, ignored for perception-0-thinking.
Return a structured JSON response instead of natural language. When true, the response populates structured_answer instead of short_answer. Reach out to [email protected] to configure structured responses.
Response
Query processed successfully
asynchronous, synchronous, background The perception model used for this query.
perception-0-fast, perception-0-thinking The status of the query. Synchronous queries always return completed status.
processing, completed, failed Whether structured output was requested for this query.
"What's happening in this video?"
Natural language answer. Populated when use_preset is false.
URI to full answer when result is too long.
Structured JSON response when use_preset is true. Reach out to [email protected] to configure structured responses.
User feedback
"2026-04-20T12:34:56.000Z"