Image Editing

With the xAI SDK, use the same sample() method; just add the image_url parameter:

import { xai } from "@ai-sdk/xai";
import { generateImage } from "ai";
import fs from "fs";

// Load image and encode as base64
const imageBuffer = fs.readFileSync("photo.png");
const base64Image = imageBuffer.toString("base64");

const { image } = await generateImage({
    model: xai.image("grok-imagine-image-2.0"),
    prompt: {
        text: "Render this as a pencil sketch with detailed shading",
        images: [`data:image/png;base64,${base64Image}`],
    },
});

console.log(image.base64);

# Using a public URL as the source image
curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Render this as a pencil sketch with detailed shading",
    "image": {
      "url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png",
      "type": "image_url"
    }
  }'

import base64
import xai_sdk

client = xai_sdk.Client()

# Load image from file and encode as base64
with open("photo.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode("utf-8")

response = client.image.sample(
    prompt="Render this as a pencil sketch with detailed shading",
    model="grok-imagine-image-2.0",
    image_url=f"data:image/png;base64,{image_data}",
)

print(response.url)

You can provide the source image as:

• A public URL pointing to an image

• A base64-encoded data URI (e.g., data:image/jpeg;base64,...)

• A file_id from the Files API — see Imagine → Files API Integration

Multi-turn editing

Chain multiple edits together by using each output as the input for the next. This enables iterative refinement; start with a base image and progressively add details, adjust styles, or make corrections.

PythonBash

import xai_sdk

client = xai_sdk.Client()

response = client.image.sample(
    prompt="A modern living room with large windows overlooking the city",
    model="grok-imagine-image-2.0",
)

print(response.url)

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "prompt": "A modern living room with large windows overlooking the city",
    "model": "grok-imagine-image-2.0"
  }'

1. Initial image2. Modify furniture3. Adjust lighting

Style transfer

The grok-imagine-image-2.0 model supports a wide range of visual styles, from ultra-realistic photography to anime, oil paintings, and pencil sketches. Transform existing images by describing the desired aesthetic in your prompt.

OriginalOil Painting

PythonBash

import xai_sdk

client = xai_sdk.Client()

response = client.image.sample(
    prompt="Render this image as an oil painting in the style of impressionism",
    model="grok-imagine-image-2.0",
    image_url="https://docs.x.ai/assets/api-examples/images/style-realistic.png",
)
print(response.url)

curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "prompt": "Render this image as an oil painting in the style of impressionism",
    "model": "grok-imagine-image-2.0",
    "image": {"url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png"}
  }'

Oil PaintingPencil SketchPop ArtAnimeWatercolor

Related

• Image Generation — Generate images from text prompts

• Multi-Image Editing — Edit with multiple source images

• Image Prompting Guide — When to edit, and how to phrase an edit prompt

• API Reference — Full endpoint documentation

• Imagine API Landing Page — Showcase of the Imagine API in action