- Published: August 13, 2026
- Last verified: August 13, 2026
- Current status: Active; current groups and prices are shown in the console
grok-imagine-image and grok-imagine-image-quality. Both models use the Images API and support five currently documented aspect ratios, 1K/2K output, up to 10 generated outputs per request, and reference-image editing. Current per-image prices are $0.02 and $0.045, respectively.
The product label is “Grok Imagine 2,” but the request model IDs do not include
2. For complete requests, parameters, editing examples, and acceptance checks, use the Grok Imagine 2 API guide.Key facts
“Up to 10 images” is the generated output count controlled by
n, not a reference-input limit. LaoZhang reference ranges are model-specific: Standard supports 1–4 and Quality supports 1–2.Who should care
- Developers who need predictable per-image budgets and 1K/2K batch generation;
- Content, advertising, and commerce teams that want multiple candidates in one request;
- Workflows that use multiple references for subject preservation, restyling, or composition and can honor model-specific input limits;
- Teams migrating from GPT-Image, Flux, or another Images API and wanting OpenAI SDK compatibility.
seed behavior should not assume direct compatibility.
What to do
1
Confirm token group and price
Open console model pricing and verify that the target token can see the model ID and current rate.
2
Choose standard or quality
Use
grok-imagine-image for routine assets and three- or four-reference composition. Compare grok-imagine-image-quality for final assets or one- to two-reference precision edits.3
Complete a one-image acceptance test
Test the target ratio and resolution with
n=1. Inspect actual dimensions, image content, response fields, and the charge before increasing batch size or concurrency.Frequently asked questions
What are the correct Grok Imagine 2 model IDs?
Usegrok-imagine-image and grok-imagine-image-quality. Neither contains 2; do not construct a model ID from the product label.
Is pricing per request or per image?
It is based on the number of successfully generated images. Current prices are $0.02/image forgrok-imagine-image and $0.045/image for grok-imagine-image-quality; n=10 can therefore create ten image charges. Use the console call log as the billing record.
Do 1K and 2K cost the same?
Yes under the current LaoZhang launch pricing for a given model. This may change with route or pricing updates, so recheck the console before a large batch.Why does the announcement list only five aspect ratios?
They are the current documented LaoZhang support scope. xAI documents more upstream ratios, but upstream capability alone does not prove that every value has been verified and committed on the current LaoZhang gateway.Which endpoint accepts reference images?
Use/v1/images/edits with multipart/form-data: image for one file and repeated image[] for multi-image edits. grok-imagine-image supports 1–4 references, and grok-imagine-image-quality supports 1–2. Text-to-image continues to use JSON at /v1/images/generations.
Must existing image workloads migrate now?
No. This is a model addition, not a retirement. Migrate only when predictable per-image cost, multi-image output, or reference editing fits the task, and only after matched-prompt acceptance testing.Evidence and related documentation
- xAI multi-image editing — upstream multi-image workflow and ordering
- xAI Grok Imagine Image model — standard-model image input
- xAI image generation documentation — upstream parameters and response formats
- xAI models and pricing — xAI list pricing, not LaoZhang API retail pricing
- Complete Grok Imagine 2 API guide — LaoZhang endpoints, code, and acceptance checks
- Image generation API selection guide — compare image models
- LaoZhang API console — current groups, prices, and recorded charges