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. |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<string> | Generated image URL(s). |
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
z-image-spicy/text-to-image
Generate high-quality images from text with custom dimensions from 256 to 1536 pixels, intelligent prompt rewriting, and seed control for creative design and batch generation.
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.
ai/prefect-pony-xl
Prefect Pony XL delivers high-quality anime-style image generation for character art and illustrations. 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.
OpenAI GPT Image 2.5 Sunburst Text-to-Image
High-fidelity image generation for detailed compositions and demanding production work, with up to 4K output.
OpenAI GPT Image 2.5 Flare Text-to-Image
Fast, balanced image generation from natural-language prompts, with up to 4K output.
krea-v2-medium/text-to-image
Krea 2 Medium Text to Image is a fast AI image generation model that creates high-quality images from text prompts with aspect ratio, creativity, and optional style reference controls. Ready-to-use REST inference API for creative design, marketing visuals, product mockups, brand assets, social media content, rapid ideation, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing.