Skip to main content
POST
Requires version 2.0.1 or later of the Archetype platform.

Overview

This endpoint sends a Direct Query request to a model that the Archetype Platform hosts. The body has the same shape as a Direct Query on /api/lens/query, and model names one of the available models. The platform forwards the body to a running copy of that model and returns its answer unchanged. Every model available on the Inference API serves this endpoint.

Request

string
required
Name of the model to query, such as newton-c-2.6 or omega-embedding. See Available Models. An unknown name returns 404.
string
The natural-language query. For omega-embedding, leave it empty and send the sensor window as a data.numeric_array event in events.
string
System prompt for this request, in place of the model’s configured one.
string
Instruction appended after the system prompt.
string
Text that seeds the start of the model’s reply.
string[]
Video for newton-c-2.6 and newton-fusion-1.0, sent inline as "base64:<mp4 data>". Still images and uploaded files (by name or by fil_ ID) are refused; send images to Chat Completions instead. See Current Limitations.
object[]
Inline data events. Only data.numeric_array events are supported on this endpoint.
integer
Maximum number of tokens to generate.
number
Sampling temperature.
boolean
Whether to sample. false uses greedy decoding.
number
Nucleus sampling cutoff.
integer
Top-k sampling cutoff.
number
Penalty for repeated tokens.
number
How long to wait for the answer before the request returns 504. It can only lower the model’s own time budget, not raise it.
boolean
Accepted for compatibility with existing Direct Query clients, and ignored: omega-embedding normalizes its input itself, whatever the value.
These fields of the /api/lens/query body aren’t supported on this endpoint. Setting one returns 400: a non-empty template_name, max_frames, presence_penalty, render: true, and multi_image: true.

Response

The model’s answer, in the Direct Query response shape. The model’s output is the array at response.response: text for newton-c-2.6 and newton-fusion-1.0, and embedding vectors for omega-embedding.

Important Notes

  • Every error is listed in Errors on the Inference API overview.
  • 400 with model '<model>' refused this request means the model rejected the body, for example because it sets one of the unsupported fields above.
  • 503 means no copy of the model is ready right now. Retry shortly.