Sends messages to a Grok chat model and returns the generated response in the
OpenAI-compatible chat completion format.

Use this when:
- You want to chat/reason with a Grok model (grok-4 / grok-3 family)
- You need vision/image understanding
- You need tool/function calling with Grok

For generating videos, use grok_text_to_video / grok_image_to_video instead.

Returns:
    JSON response containing the chat completion result.

Shows the chat models and the Grok Imagine video models with their features
and input rules. Use this to understand which model to choose.

Returns:
    Tables of all models with their capabilities.

Reference guide for what each tool does and how they fit together.

Returns:
    Categorized list of all tools and example workflows.

Shows how to structure prompts for best video generation results.

Returns:
    Complete guide with prompt structure, examples, and tips.

Use this to check if a generation is complete and retrieve the resulting
video URLs and metadata.

Use this when:
- You want to check if a generation has completed
- You need to retrieve video URLs from a previous generation
- You want to get the full details of a generated video

Task states:
- 'pending'/'processing': Generation is still in progress
- 'succeeded': Generation finished successfully
- 'failed': Generation failed (check error message)

Returns:
    Task status and generated video information including URLs and state.

Efficiently check the status of multiple tasks in a single request.
More efficient than calling grok_get_task multiple times.

Use this when:
- You have multiple pending generations to check
- You want to get status of several videos at once
- You're tracking a batch of generations

Returns:
    Status and video information for all queried tasks.

This creates a video from scratch based on your text description. Grok
Imagine will interpret your prompt and generate a matching video clip.

Use this when:
- You want to create a video from a text description
- You don't have a reference image to use
- You want maximum creative freedom

Only the 'grok-imagine-video-1.5-fast:reverse', 'grok-imagine-video:reverse',
and 'grok-imagine-video:official' models support text-to-video. For generating
a video from a reference image, use grok_image_to_video instead.

Returns:
    Task ID and generated video information including URLs and state.

This animates your input image into a video clip. Provide a prompt to
describe the motion you want, and optional reference images to guide style.

Use this when:
- You have a specific image you want to animate
- You want consistent visual style from a reference
- You want to turn a still photo into a short video

For video generation from text only, use grok_text_to_video instead.

Returns:
    Task ID and generated video information including URLs and state.