# Grok Imagine Image

xAI

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

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Grok Imagine Image (tool ID: xai.grok-imagine-image). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Generate images](https://scrollport.com/tools/image-generation-api)

**Current price:** $0.0280/image

**Availability:** Ready to run

## Tool details

**About this tool**

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.

**Inputs and outputs**

### Input

`aspect_ratio` string · 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_images` integer · optional

Value supplied for num images.

minimum: 1 · maximum: 4

`prompt` string · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

`resolution` string · optional

Value supplied for resolution.

enum: 1k, 2k

### Output

`images` array

Returned images value.

`note` string

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"}

---

Canonical page: https://scrollport.com/tools/providers/xai/grok-imagine-image