Skip to main content
← Grok Image 2.0 Endpoint: POST https://api.higgsfield.ai/xai/grok-imagine-image-2.0 Endpoint ID: xai/grok-imagine-image-2.0 ▶Open API PlaygroundGrok Image 2.0 · Generate and edit↗

Usage notes

  • Supports both text-to-image and editing: omit image_urls for generation, or supply up to 10 references for editing.
  • quality accepts low or medium only; resolution accepts 1k or 2k. aspect_ratio defaults to auto.
  • Reference images may be resized during preprocessing before submission. The request produces one image; no batch count is declared.

Quick start

Input schema

string
required
Write your prompt here
string
default:"medium"
Allowed values: "low", "medium".
array
Ordered public image reference URLs. Minimum items: 0. Maximum items: 10. Each item: string. Format: uri.
string
default:"1k"
Output resolution tier. Allowed values: "1k", "2k".
string
default:"auto"
Output width-to-height ratio. Allowed values: "auto", "1:1", "1:2", "2:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16".

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
Accepted
A completed response includes the following output fields:
See idempotent requests, polling, request errors and authentication for shared request handling.