Grok Imagine grok-imagine-edit-image API
Same API, same SDK — switch variants by changing one parameter.
# Works with Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents
npx skills add runapi-ai/grok-imagine -gInstall the Grok Imagine skill for me: 1. Clone https://github.com/runapi-ai/grok-imagine 2. Copy the skills/grok-imagine/ directory into your user-level skills directory (e.g. ~/.claude/skills/ for Claude Code, ~/.codex/skills/ for Codex). 3. Verify that SKILL.md is present. 4. Confirm the install path when done.
grok-imagine-edit-image targets the sweet spot of quality and cost within the Grok Imagine family.
- Pay-per-call pricing in USD
- Failed generations not charged
- Streaming when supported by the model
- Schema-validated tool calls
Pricing
Technical details
| Model ID | grok-imagine-edit-image |
| Provider | xAI |
| Modality | image |
| Task type | asynchronous |
| Billing unit | call |
| API endpoint | /api/v1/grok_imagine/edit_image |
| Commercial license | Yes — included via API |
| Status | Operational |
Quickstart — grok-imagine-edit-image
curl -X POST https://runapi.ai/api/v1/grok_imagine/edit_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-edit-image",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."
}'import { GrokImagineClient } from "@runapi.ai/grok-imagine";
const client = new GrokImagineClient();
const result = await client.editImage.run({
model: "grok-imagine-edit-image",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion.",
});require "runapi/grok_imagine"
client = RunApi::GrokImagine::Client.new
result = client.edit_image.run(
model: "grok-imagine-edit-image",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a short video of a robot hand placing a chess piece on a board, dramatic lighting, slow motion."
)Use grok-imagine-edit-image in four steps
Install
Install the model SDK or agent skill for this model line.
Configure
Set the model field to the full model ID shown on this page.
Call
Send a typed request with your prompt, inputs, and callback settings.
Receive
Read the task response, webhook callback, or cached output URL from RunAPI.
What's different about grok-imagine-edit-image
Prompt-guided style transfer and composition editing from one source image
Input image becomes frame 1; animates with motion + camera
Prompt-guided style transfer and composition editing from one source image
Aurora model; 7 aspect ratios; realistic/artistic/anime styles
Prompt-guided style transfer and composition editing from one source image
6–10s video from text with synchronized native audio and lip-sync
Best for
Product photography
Auto-generate lifestyle product photos for e-commerce catalogs that lack studio photography.
Game & concept art
Rapidly concept environments and characters before committing to final art.
Editorial illustration
Generate unique cover art and illustrations for blog posts and articles at scale.
Frequently asked questions about grok-imagine-edit-image
Is the model ID stable across versions?
RunAPI keeps the model ID stable and handles compatible version refreshes without changing your request shape.
What's the rate limit on this variant?
Per-key rate limits scale with usage tier. See pricing page for current limits.
Can I switch variants later?
Yes — variant is a flag. Switch by changing the model parameter.
Does it stream?
Where streaming is available, RunAPI streams end-to-end.
Where do I report quality issues?
Open an issue on the public GitHub repo or email support.
Other variants of Grok Imagine
Alternatives from other models
Flux 2
Flux Kontext
Gemini Omni