Grok Imagine Image

xAI

Generate or edit images from text prompts with aspect-ratio and output-format controls.

Capability: Image generation
Current price: $0.0280/image
Availability: Ready to run

What this API does

Create images from a prompt with fal's current Grok Imagine Image endpoint. Aspect ratio, resolution and image count are explicit; Scrollport fixes asynchronous JPEG output and stores every result as a private artifact.

Agents select this operation with tool ID xai.grok-imagine-image, then check its current inputs and price before a run.

Inputs and outputs

Input

aspect_ratiostring · optional

Value supplied for aspect ratio.

enum: 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

num_imagesinteger · optional

Value supplied for num images.

minimum: 1 · maximum: 4

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

resolutionstring · optional

Value supplied for resolution.

enum: 1k, 2k

Output

imagesarray

Returned images value.

notestring

Returned note value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "xai.grok-imagine-image",
  "input": {
    "prompt": "a cobalt reusable water bottle on a pale stone plinth, soft editorial studio lighting, crisp product photography",
    "num_images": 1,
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }
}

Output

{
  "note": "images returned as artifacts",
  "images": [
    {
      "content_type": "image/jpeg"
    }
  ]
}

Errors and limitations

invalid_input: num_images must be 1–4 and resolution must be 1k or 2kexample: {"prompt":"a cobalt reusable water bottle on a pale stone plinth, soft editorial studio lighting, crisp product photography","num_images":1,"aspect_ratio":"1:1","resolution":"1k"}

Use Grok Imagine Image with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.