xAI

Grok Imagine Quality

grok-imagine-quality/text-to-image

xAI's high-fidelity image generation and editing model, with more stable text rendering and composition, supporting 1K/2K output and consistent editing with reference images

grok-imagine-quality/image-to-image grok-imagine-quality/text-to-image

Try grok-imagine-quality/text-to-image

Input

Showcases

View all showcases

Output

image

Fill in the parameters and run — results show up here.

Pricing

grok-imagine-quality/text-to-image per image

Specifications	Unit Price
1K	$0.070
2K	$0.100

Positioning Overview

grok-imagine-quality/text-to-image is a high-fidelity text-to-image model from xAI, positioned as the quality-focused tier of the Grok Imagine image family. It generates photorealistic images from text prompts, supports 1k and 2k resolutions, 13 aspect ratios, and three output formats (jpeg, png, webp), with prompts up to 8,000 characters. Compared with the standard version, it is stronger in detail sharpness, texture and lighting naturalness, in-image text rendering, and composition stability, making it better suited to developers who need ready-to-deliver final images rather than just creative drafts.

Key Highlights

A high-fidelity tier aimed at production-grade output — details, textures, and lighting are more complete than in the standard Grok Imagine, so results come closer to directly usable finished images.
Supports both 1k and 2k resolutions — switch from fast low-resolution drafts to 2k refinement on the same API without changing models or endpoints.
13 aspect ratios cover mainstream layouts — specify ratios from 1:1 to 16:9, 9:16, 20:9, and more, fitting landscape posters, vertical social media, and widescreen banners.
More accurate in-image text rendering — better reproduction of images containing typographic layouts, reducing rework caused by garbled text in posters and social media graphics.

Capabilities

Generate photorealistic images from text prompts: enter a description to generate an image; prompts can be up to 8,000 characters, leaving room for fairly complete scene, style, and subject descriptions.

Controllable resolution and aspect ratio: choose 1k or 2k via resolution, and specify the frame among 13 ratios via aspect_ratio, so output directly matches the target material layout.

Selectable output formats: jpeg, png, and webp are supported, making it easy to choose the right encoding for front-end display, asset archiving, or downstream compression.

Named entity fidelity: rendering accuracy for named entities such as brands, public figures, and specific locations is relatively high, so you can name the subject directly in the prompt.

Use Cases

Advertising and marketing asset production — generate 2k landscape or square key visuals from product selling points and scene descriptions for hero banners, posters, and ad creatives.
Social media images and thumbnail design — generate cover images with typographic layouts in 16:9 or 9:16 for video thumbnails and social media posts.
An iterative workflow from drafts to refinement — batch-generate creative directions at 1k first, then regenerate selected ones at 2k for final delivery versions.
Scene image generation with named subjects — specify a particular car model, location, or brand in the prompt to generate contextual images for concept showcases and content illustrations.

Limitations and Selection Advice

Image quality comes at the cost of generation speed; output is slower than the standard Grok Imagine image model, so it is not suited to scenarios that need large batches of rapid drafts. High-resolution tasks and tasks with strict requirements for named subjects or image details may need multiple prompt adjustments to meet expectations; it is recommended to confirm the direction at 1k first and then render at 2k. This endpoint currently covers text-to-image only; for targeted editing based on existing images, use the image-to-image model in the same family instead. Costs are billed per image according to the platform pricing panel.

Frequently asked questions

View all FAQs →

What is Grok Imagine Quality best for?

Hero images, covers, campaign concepts, and high-quality scenes that need richer material, light, atmosphere, and detail.
How are 1k and 2k billed?

1k and 2k use separate per-image tiers. Ratio and output format do not add another fee; see the live page price for the current amounts.
Why not always use the standard tier?

Standard is better for volume drafts and speed. Choose Quality when final-image material and detail matter more.
Does it accept reference images?

The text-to-image route does not. Use grok-imagine-quality/image-to-image for quality-tier editing.

Create a generation task

POST https://api.hiapi.ai/v1/tasks

Headers

AuthorizationstringRequired

Account API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key

Content-TypestringOptional

The request body is always parsed as JSON; when sent, only application/json (optionally with charset) is accepted — any other value returns 415. Example: application/json.

Idempotency-KeystringOptional

Idempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.

Idempotency key

On network timeouts or client retries, the same key creates the task only once — no double charges (scope: the API key's account). Use a business-unique identifier as the key (e.g. "order-42"); replays return the original taskId, and keys expire 24 hours after the first request. See the Unified Async API overview for the full scenario matrix.

Body

modelstringRequired

Current fixed value: grok-imagine-quality/text-to-image

routestringOptional

Current fixed value: default

inputobjectRequired

Business parameters for grok-imagine-quality/text-to-image and route default — see the parameter table below.

promptstringRequiredminLength 1maxLength 8000

A textual description used to generate the image, provided as a string, describing the desired picture content.

resolutionstringOptionalDefault: "1k"

The resolution of the output image, provided as a string, default 1k.

Options:1k2k

aspect_ratiostringOptionalDefault: "1:1"

The aspect ratio of the generated image, provided as a string, default 1:1.

Options:2:120:919.5:916:94:33:21:12:3

Show all (5)

3:49:169:19.59:201:2

output_formatstringOptionalDefault: "jpeg"

The format of the output image, provided as a string, default jpeg.

Options:jpegpngwebp

callbackobjectOptional

Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.

Callbacks (Webhook)

Provide callback.url when creating a task and HiAPI POSTs to your service once the task reaches a terminal state — no polling needed. The callback payload mirrors the task detail structure; signature verification, delivery retries and idempotency are documented on the Unified Async API overview page.

urlstringRequired

Required when callback is present. A POST is sent to this URL once the task reaches a terminal state; must be a valid http(s) URL.

whenstringOptionalDefault: "final"

Only final is supported today — notified on both success and fail.

Options:final

storagestringOptionalDefault: "temp"

Artifact storage tier: temp (default, retained about 7 days) or persistent (long-term, billed by size). Insufficient balance or exceeding the storage cap silently downgrades to temp; the effective tier is shown in the task detail response.

Options:temppersistent

Request examples

# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-quality/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-quality/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1k",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-quality/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1k",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Get task detail

GET https://api.hiapi.ai/v1/tasks/:id

Response fields

taskIdstringRequired

Task ID, always prefixed with tk-hiapi-.

modelstringRequired

Resolved full model name. Tasks submitted with the route parameter return base@route (e.g. gpt-image-2/text-to-image@ext); otherwise identical to the name passed at creation.

routestringOptional

Present only when the task was submitted with an explicit route parameter; echoes the submitted value.

statusstringRequired

Task status.

Status values

queued Queued, not started yet. handling Being processed. archiving Processing finished, artifacts being prepared. success Terminal: completed, artifacts available (output returned). fail Terminal: failed (error returned). After submission, check status: success and fail are terminal, everything else is non-terminal. Poll every 1–3 seconds until terminal. On success, download artifacts from output[].url and transfer them before expireAt; pass storage: "persistent" at creation time when long-term retention is needed.

creatednumberRequired

Task creation time (Unix seconds).

completednumberRequired

Unix seconds when the task reached a terminal state; fixed to 0 while not terminal.

outputarrayOptional

Present only when status == success. Artifact list — always an array; a single task may return multiple types at once (e.g. video + first_frame).

Array [ object ]

Array items

urlstringRequired

Artifact URL, directly downloadable.

typestringRequired

Current possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.

expireAtnumberRequired

Unix seconds until which the artifact remains accessible; download or transfer before it expires.

errorobjectOptional

Present only when status == fail.

codestringRequired

Business error code.

messagestringRequired

Error description.

Response examples

Success

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Processing (non-terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Failed

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}