> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# roborefer

> Locate points in an image matching a spatial-referring query

Locate points in an image matching a spatial-referring query.

## Parameters

<ParamField body="image_input" type="Union[str, Image.Image, np.ndarray]" required>
  RGB image.
</ParamField>

<ParamField body="prompt" type="str" required>
  Spatial-referring query.
</ParamField>

<ParamField body="timeout" type="float | None">
  Optional HTTP timeout.
</ParamField>

## Returns

Dict\[str, Any]: `&#123;"output": &#123;"points": [[x, y], ...]&#125;&#125;` in pixel coordinates.

## Example

```python theme={null}
from grid_cortex_client import CortexClient, ModelType
client = CortexClient()
result = client.run(ModelType.ROBOREFER, image_input=image,
                    prompt="the free area between the two boxes")
print(result["output"]["points"])
```