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
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | Text description of the image to generate. |
| aspect_ratioAspect Ratio | select | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:3 | 2:1 | … | Aspect ratio of the generated 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/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:
lowandmediumlet 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
| Item | Detail |
|---|---|
| Architecture | Text-to-image generation model |
| Task type | Text to image |
| Input | Text prompt |
| Output | Image |
| Images per request | 1–10 (n, default 1) |
| Aspect ratios | 1: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 ratio | 1:1 |
| Resolution | 1k, 2k (default: 2k) |
| Quality | low, medium (default: medium) |
| Latency | Not published; stable inference with no coldstarts |
| Workflows | Creative 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
| Quality | Resolution | Price per image |
|---|---|---|
| low | 1k | $0.04 |
| low | 2k | $0.06 |
| medium | 1k | $0.06 |
| medium | 2k (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
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.
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.
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.
Nami Z-Image T2I Spicy
Generate an image from a text prompt with configurable width, height, prompt enhancement, and seed.
Nano Banana Text to Image
Gemini 2.5 Flash Image. Lightweight and fast. The most affordable option for instant, high-volume generation.
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.
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.
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.