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

xAI Grok Imagine Image v2.0 Edit example 1

Parameters

NameTypeDefaultConstraintsDescription
images *Imagesimage_upload_groupimage/* · 1–5 itemsInput images to edit. Accepts up to 5 images per request. Supports jpg, jpeg, png, and webp.
prompt *Prompttextarea≤ 5000 charsText instruction describing how to edit the image.
resolutionResolutionselect2k1k | 2kOutput image resolution tier.
qualityQualityselectmediumlow | mediumGeneration quality tier.
nImage Countslider11 ~ 10The 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: 1k and 2k outputs to trade speed and cost against detail.
  • Configurable quality tier: low and medium cover 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

ItemDetail
ArchitecturePrompt-guided image editing model
Task typeImage editing
Input1–5 images (array) + prompt
Input formatsjpg, jpeg, png, webp
OutputEdited image
Images per request1–10 (n, default 1)
Resolution1k, 2k (default: 2k)
Qualitylow, medium (default: medium)
LatencyNot published; stable inference with no coldstarts
WorkflowsVisual 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

QualityResolutionPrice per image
low1k$0.04
low2k$0.06
medium1k$0.06
medium2k (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
Image to ImageQwen Image 3.0 Pro

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.

from $0.080 / per run
Image to Image
Image to ImageNamiFusion

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.

from $0.220 / per run
Nami Qwen I2I Spicy
Image to Image

Nami Qwen I2I Spicy

Edit a reference image with natural-language instructions while preserving the parts you do not ask to change.

from $0.040 / per run
Nano Banana Image Edit
Image to ImageGoogle

Nano Banana Image Edit

Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.

from $0.040 / per run
Nano Banana Pro Image Edit
Image to ImageGoogle

Nano Banana Pro Image Edit

4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.

from $0.140 / per run
Nano Banana 2 Image Edit
Image to ImageGoogle

Nano Banana 2 Image Edit

4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.

from $0.070 / per run
Seedream V5.0 Pro Edit API
Image to ImageDoubao

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.

from $0.050 / per run
Seedream 5.0 Lite Edit Sequential
Image to ImageDoubao

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.

from $0.040 / per run