xAI Grok Imagine Image v2.0 Edit
x-ai/grok-imagine-image-v2.0/edit
xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| images *Images | image_upload_group | — | image/* · 1–5 items | Input images to edit. Accepts up to 5 images per request. Supports jpg, jpeg, png, and webp. |
| prompt *Prompt | textarea | — | ≤ 5000 chars | Text instruction describing how to edit the image. |
| resolutionResolution | select | 2k | 1k | 2k | Output image resolution tier. |
| qualityQuality | select | medium | low | medium | Generation quality tier. |
| nImage Count | slider | 1 | 1 ~ 10 | The number of images to generate (1-10). Each image is billed separately. |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/x-ai/grok-imagine-image-v2.0/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/18/d0bee8950611.jpeg"
],
"prompt": "Change the mug design to a minimalist blue geometric pattern, add a subtle coffee steam effect rising from the cup, and enhance the lighting for a polished commercial product look while keeping the background clean and neutral.",
"resolution": "2k",
"quality": "medium",
"n": 3
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/x-ai/grok-imagine-image-v2.0/edit",
headers=HEADERS,
json={
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/18/d0bee8950611.jpeg"
],
"prompt": "Change the mug design to a minimalist blue geometric pattern, add a subtle coffee steam effect rising from the cup, and enhance the lighting for a polished commercial product look while keeping the background clean and neutral.",
"resolution": "2k",
"quality": "medium",
"n": 3
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 600s server-side.
deadline = time.time() + 660
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/x-ai/grok-imagine-image-v2.0/edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": [
"https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/08/18/d0bee8950611.jpeg"
],
"prompt": "Change the mug design to a minimalist blue geometric pattern, add a subtle coffee steam effect rising from the cup, and enhance the lighting for a polished commercial product look while keeping the background clean and neutral.",
"resolution": "2k",
"quality": "medium",
"n": 3
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 600s server-side.
const deadline = Date.now() + 660 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
xAI Grok Imagine Image v2.0 Edit
Cost-effective prompt-driven image editing with no coldstarts.
xAI Grok Imagine Image V2.0 Edit transforms input images with natural language prompts, producing targeted modifications, visual refinements, and creative variations. Configurable resolution and quality balance editing precision, latency, and cost for marketing updates, social content, and everyday production workflows.
🚀 Key Features
- Prompt-driven editing: Describe the change in natural language, no manual masking required.
- Multi-reference editing: Up to 5 input images per request for blending, transfer, and cross-image consistency.
- Configurable resolution:
1kand2koutputs to trade speed and cost against detail. - Configurable quality tier:
lowandmediumcover everything from fast previews to final renders. - Batch output: Up to 10 edited results per request for side-by-side comparison.
- No coldstarts: Suited to latency-sensitive online applications and batch production.
🛠️ Specifications
| Item | Detail |
|---|---|
| Architecture | Prompt-guided image editing model |
| Task type | Image editing |
| Input | 1–5 images (array) + prompt |
| Input formats | jpg, jpeg, png, webp |
| Output | Edited image |
| Images per request | 1–10 (n, default 1) |
| Resolution | 1k, 2k (default: 2k) |
| Quality | low, medium (default: medium) |
| Latency | Not published; stable inference with no coldstarts |
| Workflows | Visual refinement, creative iteration, marketing updates, production pipelines |
Example prompts
- Replace the product background with a clean light-grey studio scene, preserving subject detail and realistic shadows.
- Grade this street photo toward a cinematic dusk mood with warm lighting and aerial perspective.
- Change the outfit to modern minimalist styling while keeping the original pose and composition.
💰 Pricing
| Quality | Resolution | Price per image |
|---|---|---|
| low | 1k | $0.04 |
| low | 2k | $0.06 |
| medium | 1k | $0.06 |
| medium | 2k (default) | $0.08 |
| Input image | $0.01 / image |
|---|
Billing notes
- Priced by quality tier x resolution; all four combinations differ.
- Total = price per image x
n(number of images) + $0.01 x number of input images. - Input images are charged once per request and do not scale with
n. - When quality and resolution are not specified, billing uses the defaults
medium+2k.
💡 Best Use Cases
- E-commerce and retail: Refine product backgrounds, lighting, palette, and presentation for consistent listings.
- Social content production: Generate multiple visual variants of one asset for different platforms and campaigns.
- Marketing asset updates: Low-cost iteration on ad creatives, posters, and brand visuals.
- Creative and design workflows: Explore editing directions quickly before committing to final design.
🔗 Related Models
- xAI Grok Imagine Image v2.0 Text to Image: Generate new images from a prompt with no input image.
- xAI Grok Imagine Video v1.5 Image to Video: Animate the edited image into a video.
Related models
Qwen Image 3.0 Pro Edit | Fast Image Editing
Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Head Swap (Image)
Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.
Nami Qwen I2I Spicy
Edit a reference image with natural-language instructions while preserving the parts you do not ask to change.
Nano Banana Image Edit
Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.
Nano Banana Pro Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Nano Banana 2 Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Seedream V5.0 Pro Edit API
Seedream V5.0 Pro Edit by ByteDance edits and generates images from single-image or multi-reference inputs, supporting up to 10 reference images, aspect ratio selection, and 1K / 2K output tiers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Seedream 5.0 Lite Edit Sequential
Seedream 5.0 Lite Edit Sequential performs multi-image editing while locking character and object identity across shots. It detects main subjects, preserves continuity, and applies controlled edits with up to 4K output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.