Grok Imagine Image 2.0 API

About Grok Imagine Image 2.0

Text-to-image plus multi-reference editing with up to five source images, automatic or pinned quality tiers, and 1K or 2K output resolution.

Also known as Grok Imagine Image, xAI Grok Imagine Image 2.0

Grok Imagine Image 2.0 specs

Model ID

grok-imagine-image-2-0

Provider

xAI

Category

Image Generation

Released

Aug 7, 2026

Input

TextImage

Output

Image

Endpoints

POST/v1/images/generationsPOST/v1/images/edits

Alternate model IDs

grok-imagine-image-2grok-imagine-image-2.0xai/grok-imagine-image-2-0xai/grok-imagine-image-2xai/grok-imagine-image-2.0

Grok Imagine Image 2.0 API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

How to call the Grok Imagine Image 2.0 API

Grok Imagine Image 2.0 runs through POST /v1/images/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Or add "sync": true to skip polling: the request stays open and returns the finished OpenAI-style image response directly, so OpenAI SDKs work as-is. Get an API key from the EmpirioLabs dashboard.

curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2-0",
    "prompt": "Describe what you want Grok Imagine Image 2.0 to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "grok-imagine-image-2-0",
        "prompt": "Describe what you want Grok Imagine Image 2.0 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Grok Imagine Image 2.0 API parameters

Request parameters supported by the Grok Imagine Image 2.0 API on EmpirioLabs. Defaults apply when a field is omitted.

Good to know

Generates images from a text prompt, or edits up to five source images from a natural-language instruction.

Modes

• Text-to-image: send a prompt with no image.
• Image editing: attach one image and describe the change you want.
• Multi-image editing: attach two to five images to combine subjects, transfer a style, or compose a scene. Refer to them in the prompt as <IMAGE_0>, <IMAGE_1>, and so on.

Example multi-image prompt

Place the product from <IMAGE_0> onto the marble surface in <IMAGE_1>.

Defaults

• Auto quality at 1K resolution
• Auto aspect ratio, so the model picks the best fit for the prompt
• One output image per request

Quality and resolution

Quality selects how much work goes into the render. Auto lets the model choose the tier for each request and currently serves low for a text prompt and medium for an edit. Low returns in a few seconds. Medium takes longer and resolves finer detail. Resolution selects the 1K or 2K output tier. Quality and resolution combine into four price points, so a low 1K image is the cheapest option and a medium 2K image the most detailed.

Controls

Supports prompt, source images (URL or upload), quality, resolution, aspect ratio across sixteen ratios including auto and the 21:9 and 5:2 widescreen formats, number of images, and response format.

Limits

• Up to 5 source images per edit
• Up to 10 output images per request
• Prompt up to 8,000 characters

Billing

• Charged per output image at the quality and resolution served, plus a per-image fee for each source image you attach. Text-to-image has no source-image fee.
• With auto quality the charge follows the tier the model served for that request. Set quality to low or medium when you want the price fixed in advance.
• A request that fails validation or is rejected before any image is produced is not billed.
• An image that is produced but then blocked by content policy is still billed. This follows xAI usage policy, which charges for the generation even when the output is blocked by the content safety check. Keep prompts and source images within the usage policy to avoid this.

Content safety

Generated images pass an automated content-safety check. An image flagged as explicit is not returned. Because the image is generated before the check runs, a flagged generation is still billed.

Grok Imagine Image 2.0 API: common questions

How much does the Grok Imagine Image 2.0 API cost?

On EmpirioLabs, Grok Imagine Image 2.0 is billed pay as you go: Low quality, 1K $0.048 per image; Low quality, 2K $0.072 per image; Medium quality, 1K $0.072 per image. The live rate card on this page always matches what the API charges.

Which endpoint does Grok Imagine Image 2.0 use?

Grok Imagine Image 2.0 is served through POST /v1/images/generations on api.empiriolabs.ai with standard bearer-token authentication.

Can I try Grok Imagine Image 2.0 in the browser before integrating?

Yes. The EmpirioLabs playground runs Grok Imagine Image 2.0 in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Grok Imagine Image 2.0 API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make.