About

Imported from calesthio/openmontage (.agents/skills/grok-media/SKILL.md) via skills.sh. Install upstream with npx skills add calesthio/openmontage --skill grok-media. Copyright stays with the author.

Grok Media

Name: grok-media
Author: calesthio

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/calesthio-openmontage-grok-media/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

calesthio-openmontage-grok-media.ocm.jsonjson

{
  "ocm": "1",
  "id": "calesthio-openmontage-grok-media",
  "kind": "skill",
  "name": "grok-media",
  "description": "xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling.",
  "publisher": "calesthio",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "xai",
      "grok",
      "image-generation",
      "video-generation",
      "media",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "xAI Grok image and video generation guide covering authentication, endpoints, prompt structure, image editing, reference-image video, and async polling."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/calesthio/openmontage",
      "path": ".agents/skills/grok-media/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/calesthio/openmontage/grok-media",
      "key": "calesthio/openmontage/.agents/skills/grok-media/SKILL.md"
    }
  },
  "instructions": "# Grok Media\n\nUse this skill when working with xAI media models in OpenMontage.\n\n## Models\n\n- `grok-imagine-image` for image generation and image editing\n- `grok-imagine-video` for text-to-video, image-to-video, and reference-image video\n\n## Authentication\n\n- Env var: `XAI_API_KEY`\n- Base URL: `https://api.x.ai/v1`\n- Header: `Authorization: Bearer $XAI_API_KEY`\n\n## Image API\n\n### Text-to-image\n\n- Endpoint: `POST /images/generations`\n- Core fields:\n  - `model`\n  - `prompt`\n  - `n`\n  - `aspect_ratio`\n  - `resolution`\n\n### Image edit\n\n- Endpoint: `POST /images/edits`\n- Use `image` for one source ",
  "cost": {
    "context_tokens": 873
  }
}

Fetch it by URL: GET /api/v1/registry/calesthio-openmontage-grok-media/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.