Xai Grok Imagine Image API

Grok Imagine Image
Edit

Endpoint: POST https://fal.run/xai/grok-imagine-image Endpoint ID: xai/grok-imagine-image

Try it in the Playground

Run this model interactively with your own prompts.

Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "xai/grok-imagine-image",
    arguments={
        "prompt": "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic scientific"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("xai/grok-imagine-image", {
  input: {
      prompt: "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic scientific"
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/xai/grok-imagine-image \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic scientific"
}'

Input Schema

string

required

Text description of the desired image.

integer

default:"1"

Number of images to generate. Default value: 1Range: 1 to 4

AspectRatioEnum

default:"1:1"

Aspect ratio of the generated image. Default value: "1:1"Possible values: 2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2

ResolutionEnum

default:"1k"

Resolution of the generated image. 1k for standard resolution, 2k for high resolution. Default value: "1k"Possible values: 1k, 2k

OutputFormatEnum

default:"jpeg"

The format of the generated image. Default value: "jpeg"Possible values: jpeg, png, webp

boolean

default:"false"

If True, the media will be returned as a data URI and the output data won’t be available in the request history.

Output Schema

list<ImageFile>

required

The URL of the generated image.

string

required

The enhanced prompt that was used to generate the image.

Input Example

{
  "prompt": "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic scientific",
  "num_images": 1,
  "aspect_ratio": "1:1",
  "resolution": "1k",
  "output_format": "jpeg",
  "sync_mode": false
}

Output Example

{
  "images": [
    {
      "url": "https://v3b.fal.media/files/b/0a8b90b7/9avg_nKJmcVinjQHJR_Ja.jpg"
    }
  ],
  "revised_prompt": ""
}

Endpoint: POST https://fal.run/xai/grok-imagine-image/edit Endpoint ID: xai/grok-imagine-image/edit

Try it in the Playground

Run this model interactively with your own prompts.

Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "xai/grok-imagine-image/edit",
    arguments={
        "prompt": "Make this scene more realistic but still keep the game vibes"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("xai/grok-imagine-image/edit", {
  input: {
      prompt: "Make this scene more realistic but still keep the game vibes"
    },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

curl --request POST \
  --url https://fal.run/xai/grok-imagine-image/edit \
  --header "Authorization: Key $FAL_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "Make this scene more realistic but still keep the game vibes"
}'

Input Schema

string

required

Text description of the desired image.

integer

default:"1"

Number of images to generate. Default value: 1Range: 1 to 4

ResolutionEnum

default:"1k"

Resolution of the generated image. 1k for standard resolution, 2k for high resolution. Default value: "1k"Possible values: 1k, 2k

OutputFormatEnum

default:"jpeg"

The format of the generated image. Default value: "jpeg"Possible values: jpeg, png, webp

boolean

default:"false"

If True, the media will be returned as a data URI and the output data won’t be available in the request history.

list<string>

List of URLs of the images to edit. A maximum of 3 images are supported.

Output Schema

list<ImageFile>

required

The URL of the edited image.

string

required

The enhanced prompt that was used to generate the image.

Input Example

{
  "prompt": "Make this scene more realistic but still keep the game vibes",
  "num_images": 1,
  "resolution": "1k",
  "output_format": "jpeg",
  "sync_mode": false,
  "image_urls": [
    "https://v3b.fal.media/files/b/0a8b911d/Abk8vStrvmSPlzUqI_NN3_image_043.png"
  ]
}

Output Example

{
  "images": [
    {
      "url": "https://v3b.fal.media/files/b/0a8b911d/XMqiVoO2ECXUZEUYmPl2l.jpg"
    }
  ],
  "revised_prompt": ""
}

Grok Imagine Image — Image Generation

Limitations

num_images range: 1 to 4
resolution restricted to: 1k, 2k
output_format restricted to: jpeg, png, webp

Video Generation

Image Generation

Audio

Vision

3D

Xai Grok Imagine Image API

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Limitations

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

​Related

​Limitations

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Related

Limitations