Struct GroundRequest 

pub struct GroundRequest {
    pub image: ContentBlock,
    pub prompt: String,
    pub model: Option<String>,
    pub labels: Option<Vec<String>>,
}

A request for structured visual grounding.

Unlike crate::GenerateRequest, this is the dedicated entry point for localization tasks — callers get back typed BoundingBoxes rather than having to grep them out of a text response. Internally it still runs through the generate path and parses Qwen-style spans from the output; the dedicated type exists so callers can express intent explicitly and so future routing can prefer models with the Grounding capability.

Fields

image: ContentBlock

Image content to ground against. Exactly one image is expected — multi-image grounding is provider-specific and not yet standardized across VL models.

prompt: String

Free-form text prompt describing what to localize (e.g. “Find all the street signs”).

model: Option<String>

Optional model override. When unset, routes to the preferred model declaring the Grounding capability.

labels: Option<Vec<String>>

Optional explicit label list. When provided, callers can post-filter the returned boxes to these label names. Not currently sent to the model (Qwen2.5-VL derives labels from the prompt); reserved for providers that accept a controlled vocabulary on the request.

Trait Implementations

impl Clone for GroundRequest

fn clone(&self) -> GroundRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GroundRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GroundRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GroundRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.