Grok Media

Use this skill when working with xAI media models in OpenMontage.

Models

• grok-imagine-image for image generation and image editing
• grok-imagine-video for text-to-video, image-to-video, and reference-image video

Authentication

• Env var: XAI_API_KEY
• Base URL: https://api.x.ai/v1
• Header: Authorization: Bearer $XAI_API_KEY

Image API

Text-to-image

• Endpoint: POST /images/generations
• Core fields:
  • model
  • prompt
  • n
  • aspect_ratio
  • resolution

Image edit

• Endpoint: POST /images/edits
• Use image for one source image
• Use images for multi-image compositing
• Each source image can be:
  • a public HTTPS URL
  • a base64 data URI

Image prompting

• Grok responds well to direct natural language
• For edits, describe only the intended change and preserve everything else implicitly
• For multi-image merges, explicitly name how each source contributes
• Prefer one strong scene description over long style-stacking

Video API

Generation

• Endpoint: POST /videos/generations
• Polling endpoint: GET /videos/{request_id}
• Success state: status == "done"
• Failure states to handle explicitly: failed, expired

Modes

• Text-to-video:
  • prompt-only generation
• Image-to-video:
  • use image: {"url": ...}
  • this anchors the starting frame
• Reference-to-video:
  • use reference_images: [{"url": ...}, ...]
  • this influences who/what appears in the video without locking the first frame
  • prompts can reference inputs with placeholders like <IMAGE_1>, <IMAGE_2>

Video constraints

• Grok video is best treated as short-form generation
• Current output resolutions are 480p and 720p
• Reference-image video supports multiple images and is useful for product placement, wardrobe transfer, and identity consistency
• Download outputs promptly; provider URLs may be temporary

Pricing