X Ai Grok Imagine Image Quality Text To Image
Playground
Try it on WavespeedAI!xAI Grok Imagine Image Quality Text to Image is a fast AI image generation model that creates high-quality images from text prompts using a dedicated RunPod workflow. Ready-to-use REST inference API for creative design, concept art, marketing visuals, product mockups, social media content, and professional AI image generation workflows with simple integration, no coldstarts, and affordable pricing.
Features
xAI Grok Imagine Image Quality Text-to-Image
xAI Grok Imagine Image Quality Text-to-Image generates high-quality images from text prompts with support for multiple aspect ratios, two resolution tiers, selectable output formats, and multi-image generation in a single request. It is suitable for concept art, marketing creatives, social media visuals, product imagery, and other prompt-driven image generation workflows.
Why Choose This?
-
High-quality text-to-image generation Turn natural-language prompts into polished visual outputs.
-
Flexible aspect ratios Choose from common preset aspect ratios for social, editorial, and widescreen content.
-
Two resolution tiers Select
1kor2kdepending on your quality and budget needs. -
Multiple image generation Generate up to
4images in one request withnum_images. -
Multiple output formats Export results as
jpeg,png, orwebp. -
Simple pricing Pricing depends only on
resolutionandnum_images.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text prompt describing the image you want to generate. |
| aspect_ratio | No | Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3. Default: 1:1. |
| resolution | No | Output resolution tier: 1k or 2k. Default: 1k. |
| num_images | No | Number of images to generate. Range: 1–4. Default: 1. |
| output_format | No | Output image format: jpeg, png, or webp. Default: jpeg. |
How to Use
- Write your prompt — describe the subject, style, lighting, composition, and mood you want.
- Choose aspect ratio — select the format that best fits your use case.
- Choose resolution — use
1kfor lower cost or2kfor higher-quality output. - Set number of images — choose how many images you want to generate, from
1to4. - Choose output format — select
jpeg,png, orwebp. - Submit — run the model and download the generated images.
Example Prompt
A futuristic city street at night, neon reflections on wet pavement, cinematic lighting, ultra-detailed, high contrast, atmospheric sci-fi mood
Pricing
Pricing is based on resolution and num_images.
Per Image
| Resolution | Cost per Image |
|---|---|
| 1k | $0.06 |
| 2k | $0.08 |
Example Costs
| Resolution | 1 Image | 2 Images | 3 Images | 4 Images |
|---|---|---|---|---|
| 1k | $0.06 | $0.12 | $0.18 | $0.24 |
| 2k | $0.08 | $0.16 | $0.24 | $0.32 |
Billing Rules
1kcosts $0.06 per image2kcosts $0.08 per image- Total price = per-image price ×
num_images aspect_ratioandoutput_formatdo not affect pricing
Best Use Cases
- Concept art — Generate visual ideas and creative directions from text.
- Marketing creatives — Produce ad visuals, banners, and campaign imagery.
- Social media content — Create prompt-driven images for posts and promotional content.
- Product and brand visuals — Generate polished imagery for presentations and ideation.
- Rapid iteration — Use
num_imagesto explore multiple variations in a single run.
Pro Tips
- Be specific in your prompt about subject, background, lighting, and style.
- Use
1kfor quick iteration and2kfor higher-quality final outputs. - Increase
num_imageswhen you want multiple variations from the same prompt. - Use
pngwhen image quality matters more than file size. - Short, focused prompts often produce more controllable results than overly long descriptions.
Notes
promptis the only required field.num_imagessupports values from1to4.aspect_ratiodefaults to1:1.resolutiondefaults to1k.output_formatdefaults tojpeg.- Pricing depends only on
resolutionandnum_images.
Related Models
- Other xAI image generation models may be useful when you need different quality, style, or workflow trade-offs.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-image-quality/text-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"aspect_ratio": "1:1",
"resolution": "1k",
"num_images": 1,
"output_format": "jpeg",
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The prompt for image generation or editing. | |
| aspect_ratio | string | No | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 | Aspect ratio of the generated image. |
| resolution | string | No | 1k | 1k, 2k | Output resolution tier. |
| num_images | integer | No | 1 | 1 ~ 4 | Number of images to generate. Range: 1-4. |
| output_format | string | No | jpeg | jpeg, png, webp | Output image format. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated images. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |