v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0131922.5 KB

Inference

Run Locate

post/api/v1/inference/locate

Request body

imagestring required

Base64 encoded image (PNG or JPEG)

querystring required

Natural-language target description

modelstring nullable

VLM model to use; must be one of the models from GET /inference/models. Omit to use the server's configured default. The system prompt is fixed to the element-locator task.

Response

Successful Response

foundboolean required

Whether the VLM located the target

confidencenumber required

Model self-reported confidence

matched_text_indexinteger nullable

Index into the request texts list when the answer is OCR-grounded.

modelstring required

Model identifier returned by the provider

cost_microdollarsinteger required

Provider-reported cost in microdollars

prompt_tokensinteger

Prompt (input) tokens the model billed for this call

completion_tokensinteger

Completion (output) tokens the model billed for this call

latency_msinteger required

End-to-end VLM call latency