xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.

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 grok imagine image : $0.02 per generated image grok imagine image edits/composites: add $0.002 per input image grok imagine video : 480p : $0.05 per second 720p : $0.07 per second grok imagine video image conditioned requests: add $0.002 per input image Grok Specific Prompt Guidance Images Start with subject, action, setting Add one style anchor, not five For edits: describe the desired modification keep the rest of the image stable by omission, not by writing a giant preservation list Video Keep prompts scene local: one shot, one main motion idea, one emotional beat For reference conditioned video, explicitly map source images to roles: person from <IMAGE 1 jacket from <IMAGE 2 product from <IMAGE 3 Camera and pacing language helps: slow push in handheld follow locked off medium shot high energy whip pan transition Good Fits Image style transfer Image compositing from multiple sources Reference conditioned short video Product led motion clips Character consistent scenes without hard first frame lock Weak Fits Long form clip generation Heavy reliance on deterministic seeds Overloaded prompts with multiple scene changes Failure Handling If generation submission succeeds but polling expires, surface it as a provider/runtime issue If a request fails, preserve the endpoint, mode, and prompt summary in the error Do not silently substitute a different provider after xAI was selected without user approval

grok-media