Skip to main content
  • Published: September 3, 2026
  • Last verified: September 3, 2026
  • Current status: Active; text-to-image and three-reference editing were verified on the public API domain
LaoZhang API now provides grok-imagine-image-2.0. The current price is $0.055 per successfully returned image. Text-to-image supports 1K/2K, Low/Medium, 15 fixed aspect ratios, and up to 10 outputs per request. Image editing accepts one to three reference files through an OpenAI-compatible multipart endpoint.
The exact model ID is grok-imagine-image-2.0, including the final .0. The legacy grok-imagine-image and grok-imagine-image-quality models remain available, and existing calls do not need to migrate immediately.

​
Key facts

Editing currently requires multipart file uploads. xAI’s JSON image objects and four- or five-reference requests are outside this launch scope. Do not retry these known input-boundary failures as if they were temporary outages.

​
Who should care

  • Developers who want a lower price than xAI’s current highest text-to-image tier;
  • Content, advertising, and commerce apps that need 1K/2K, Low/Medium, and varied landscape or portrait layouts;
  • Workflows that combine a subject, scene, and style from two or three references;
  • Teams using the OpenAI Python SDK that want to change the Base URL, API key, and model ID.
Applications that require xAI JSON editing, four or five references, 4K, mask inpainting, a reproducible seed, or arbitrary pixel dimensions should not migrate directly.

​
What to do

1

Confirm the model and price

Open model pricing, verify that the token can see grok-imagine-image-2.0, and confirm that the current price remains $0.055.
2

Generate one image first

Start with n=1, 1K, and Low. Download the image and inspect its actual dimensions, content, and call record.
3

Add only the parameters you need

Test the exact 2K, Medium, aspect ratio, batch count, or reference-editing combination used in production instead of starting at maximum batch size.
Minimal text-to-image request:
See the Grok Imagine Image API integration guide for Python, all 15 aspect ratios, full parameter details, and error handling.

​
Three-reference editing

Repeat image[] for multiple files:
Upload order maps to image 1, image 2, and image 3 in the prompt. The launch check on api2.laozhang.ai returned a decodable 1248×832 JPEG and confirmed that all three reference subjects affected the result.
The current limit is three references. Reject a fourth file in the client. A known over-limit request may return HTTP 500 and should not be retried automatically.

​
Pricing and billing

Billing is per successful output image, not per HTTP request: LaoZhang currently uses the same public price for 1K/2K and Low/Medium. Pricing may change with service costs. Recheck the console before large batches and use call records as the final billing source. General service and billing rules are governed by the Terms.

​
Known boundaries

  • quality="high" is not allowed and should be rejected by the client;
  • resolution="4k" is not supported;
  • four- and five-reference editing is not supported;
  • xAI JSON image-editing requests are not currently supported;
  • URL outputs are temporary and should be downloaded promptly;
  • Medium and 2K can take substantially longer than 1K Low, so use a 180-second production hard timeout.

​
Frequently asked questions

​
Is $0.055 charged per request or per output image?

It is charged per successfully returned image. A successful n=10 response with ten images costs $0.550. If a request fails without returning an image, check the call record for the final charge.

​
How many reference images can I upload?

One to three through multipart file upload. Four and five references are not currently supported.

​
Do 1K, 2K, Low, and Medium have the same price?

Yes. The current LaoZhang public price is $0.055 per successful output image. Latency and service costs vary by tier, so this price may change.

​
Why can I not copy xAI’s JSON editing example directly?

LaoZhang currently verifies OpenAI-compatible multipart uploads. JSON image objects return HTTP 400, so use the file-upload example in the integration guide.

​
Must legacy model users migrate now?

No. grok-imagine-image and grok-imagine-image-quality remain available. Migrate only after a matched-prompt test shows that 2.0’s quality, aspect ratios, or three-reference editing better fits the task.