<< Click to Display Table of Contents >> Navigation:  3. Script Language > AI - Artificial Intelligence Commands > AIX. - Grok / X - API > !Core Operations > AIX. - Grok / X - API

---

MiniRobotLanguage (MRL)

 

AIX.Ask Vision
Ask a Vision-Based Question with an Image

 

Intention

 

AskVision Command: Querying Grok with Images
 
The Ask Vision Command allows you to send a question to the Grok API along with an image, enabling vision-based analysis or descriptions.

This enhances your ability to interact with AI by combining text prompts with visual data.

It�s part of the AIX - Grok / X - API suite.

 

What is the AskVision Command?

 

The Ask Vision Command sends a chat completion request to the Grok API, including a text prompt and an optional Base64-encoded image.

Grok processes the image and text together, returning a response based on both inputs, stored in AIX_GrokContent.

 

Why Do You Need It?

 

This Command is essential for:

�Image Analysis: Ask questions about image content (e.g., "What�s in this picture?").

�Contextual Understanding: Combine visual and textual data for richer responses.

�Automation: Integrate vision capabilities into your workflows.

 

How to Use the AskVision Command?

 

Provide a text prompt and a Base64-encoded image string, optionally enabling clipboard output.

The response is stored in AIX_GrokContent and can be retrieved with AIX.Get Content.

 

Example Usage

 

AIX.SetAPI_Key|your_api_key_here

AIX.Ask Vision|What�s in this image?|1|Base64ImageString

DBP.Response: $$AIX_GrokContent

 

The response might describe the image content, copied to the clipboard if enabled.

 

Illustration

 

+---------------+

� Prompt + Image�

+---------------�

� Grok Response �

+---------------+

Sending a prompt and image to Grok for analysis.

 

Syntax

 

AIX.AskVision|P1|P2|P3

AIX.Ask Vision|P1|P2|P3

 

Parameter Explanation

 

P1 - The text prompt or question to send to Grok (required).

P2 - (Optional) Clipboard flag: 1 to copy the response to the clipboard, 0 otherwise (default: uses AIX_ClipboardOutput).

P3 - (Required) Base64-encoded image data for vision support.

 

Example

 

AIX.Ask Vision|Describe this image|1|Base64EncodedImage

DBP.Grok says: $$AIX_GrokContent

ENR.

 

Remarks

 

- Requires a valid API key set via AIX.Set Key.

- Image data must be Base64-encoded; response is text-based (e.g., descriptions).

 

Limitations

 

- Clipboard output is limited to 1MB (%MAX_CLIPBOARD_SIZE).

- Vision support depends on the model (e.g., grok-2); check AIX.Set Model.

 

See also:

 

? AIX.Ask

? AIX.Get Content

? AIX.Set Key

? AIX.Set ClipboardOutput