xAI Grok Imagine Image v2.0 Text to Image

x-ai/grok-imagine-image-v2.0/text-to-image

xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality images from text prompts, with configurable aspect ratio, resolution, and quality for creative visuals, 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 Text to Image example 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea≤ 5000 charsText description of the image to generate.
aspect_ratioAspect Ratioselect1:11:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:3 | 2:1 | …Aspect ratio of the generated 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/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic futuristic city skyline at sunset, viewed from a rooftop garden, with glowing neon signs, flying vehicles, reflective glass towers, and soft golden light breaking through dramatic clouds; ultra-detailed, photorealistic, vibrant colors, sharp focus",
    "aspect_ratio": "16:9",
    "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/text-to-image",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "A cinematic futuristic city skyline at sunset, viewed from a rooftop garden, with glowing neon signs, flying vehicles, reflective glass towers, and soft golden light breaking through dramatic clouds; ultra-detailed, photorealistic, vibrant colors, sharp focus",
            "aspect_ratio": "16:9",
            "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/text-to-image", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "A cinematic futuristic city skyline at sunset, viewed from a rooftop garden, with glowing neon signs, flying vehicles, reflective glass towers, and soft golden light breaking through dramatic clouds; ultra-detailed, photorealistic, vibrant colors, sharp focus",
      "aspect_ratio": "16:9",
      "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 Text to Image

High-quality text-to-image generation with no coldstarts, built for fast iteration and production workflows.

xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality visuals from natural language prompts. Configurable aspect ratio, resolution, and quality make it suitable for everything from creative exploration to production delivery, with stable latency and predictable cost.

🚀 Key Features

  • High-quality generation: Sharp, detailed images from natural language prompts for creative visuals, marketing assets, and concept design.
  • Flexible aspect ratios: 13 common and mobile-friendly ratios for social media, commerce, and content publishing.
  • 1k / 2k resolution: Iterate quickly at 1k, deliver finished assets at 2k.
  • Adjustable quality tier: low and medium let you trade speed and cost against visual fidelity.
  • Batch generation: Up to 10 images per request to speed up exploration and selection.
  • No coldstarts: Suited to high-frequency calls and stable production environments.

🛠️ Specifications

ItemDetail
ArchitectureText-to-image generation model
Task typeText to image
InputText prompt
OutputImage
Images per request1–10 (n, default 1)
Aspect ratios1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
Default aspect ratio1:1
Resolution1k, 2k (default: 2k)
Qualitylow, medium (default: medium)
LatencyNot published; stable inference with no coldstarts
WorkflowsCreative generation, visual ideation, marketing assets, production image output

Example prompts

  • A cinematic sunrise over the ocean, towering waves, golden morning light, highly detailed, photorealistic
  • Minimalist premium skincare product shot, clean background, soft studio lighting, commercial advertising quality
  • Futuristic city nightscape concept art, neon reflections, rain-soaked streets, wide-angle lens, cyberpunk style

💰 Pricing

QualityResolutionPrice per image
low1k$0.04
low2k$0.06
medium1k$0.06
medium2k (default)$0.08

Billing notes

  • Priced by quality tier x resolution; all four combinations differ.
  • Total = price per image x n (number of images).
  • Aspect ratio does not affect price.
  • When quality and resolution are not specified, billing uses the defaults medium + 2k.

💡 Best Use Cases

  • Marketing and social visuals: Ad creatives, campaign posters, social imagery, and brand content.
  • Ideation and concept design: Concept art, scene exploration, character direction, and visual proposals.
  • E-commerce and product imagery: Product scenes, brand assets, and promotional visuals.
  • Content production workflows: Stable output, frequent iteration, and predictable cost.

🔗 Related Models

  • xAI Grok Imagine Image v2.0 Edit: Edit existing images with text instructions, up to 5 reference images.
  • xAI Grok Imagine Video v1.5 Text to Video: The video counterpart in the same family.

Related models

Qwen Image 3.0 Pro Text to Image
Text to ImageQwen Image 3.0 Pro

Qwen Image 3.0 Pro Text to Image

Qwen Image 3.0 Pro is a professional-grade text-to-image model with superior quality and advanced prompt understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.080 / per run
OpenAI GPT Image 2 Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2 Text-to-Image

OpenAI's GPT Image 2 Text-to-Image generates high-quality images from natural-language prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.660 / per run
OpenAI GPT Image 2 Edit
Text to ImageOpenAI

OpenAI GPT Image 2 Edit

OpenAI's GPT Image 2 Edit enables image editing from natural-language instructions with one or more reference images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.660 / per run
Nami Z-Image T2I Spicy
Text to Image

Nami Z-Image T2I Spicy

Generate an image from a text prompt with configurable width, height, prompt enhancement, and seed.

from $0.020 / per run
Nano Banana Text to Image
Text to ImageGoogle

Nano Banana Text to Image

Gemini 2.5 Flash Image. Lightweight and fast. The most affordable option for instant, high-volume generation.

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

Nano Banana Pro Text to Image

Gemini 3.0 Pro Image. The high-fidelity choice for 4K visuals, multilingual text rendering, and pro camera controls.

from $0.140 / per run
Nano Banana Pro Text to Image
Text to ImageGoogle

Nano Banana Pro Text to Image

Gemini 3.0 Pro Image. The high-fidelity choice for 4K visuals, multilingual text rendering, and pro camera controls.

from $0.070 / per run
Google Nano Banana Lite Text to Image API
Text to ImageGoogle

Google Nano Banana Lite Text to Image API

Google Nano Banana 2 Lite Text to Image generates high-quality images from text prompts with low latency, flexible aspect ratios, and fast image creation for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.040 / per run