Index of every page on this site: llms.txt
All skills
openmontageinc avatar

/grok-media

@2e003e6
by openmontageincopenmontageinc/openmontage82k stars
11,135
Run it yourself

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

Use this Skill: https://skilld.dev/gh/openmontageinc/openmontage/grok-media

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈41 tokens for metadata: the name and description. ≈874 when used: this file.

Description uses 2.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈165 characters, or 2.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts11d3 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    The skill provides a technical guide for using xAI Grok media models. It follows best practices for authentication and uses legitimate endpoints. However, it defines an attack surface for indirect prompt injection by instructing the agent to process untrusted external image URLs and prompts without providing specific sanitization or boundary guidance.

  • Socket12d

    No alerts

  • Snyk11d

    Risk: LOW · No issues

Signed by skilld at 2e003e6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "author": "OpenMontage",
  "version": "1.0.0",
  "tags": "xai, grok, image-generation, video-generation, media"
}

README badge

README badge for openmontageinc/openmontage/grok-media