Image Generation

Grok Image Edit API

xAI Grok image editing. Sync response (no polling). Provide an image URL and a text edit instruction. Optional quality tier for 1k/2k high-fidelity edits. Integrate this model via REST with endpoint docs, parameters, and code examples.

Compare image models Use cases

Img2Img

Credit Cost

1 credit

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/xai-image-edit/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/xai-image-edit.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text instruction describing the edit to apply	-
`image_url` required	string	URL of the image to edit (jpg, jpeg, png, webp)	-
`quality`	enum	fast (1 credit, default), quality (1.5 credits at 1k, 2 credits at 2k) or imagine-2 (2 credits, Grok Imagine 2). Quality has sharper detail and stronger text rendering. `fastqualityimagine-2`	`fast`
`resolution`	enum	1k or 2k output. Only applies to the quality tier; imagine-2 edits keep the source image size. `1k2k`	`2k`

Use saved characters (@Name)

This model takes no reference images, so @Name of a saved character is refused (400) before anything is charged. A saved location, prop or style with a description is inserted as text. For saved characters, use a model that takes reference images, such as Nano Banana Pro or Seedream 5 for images, or Seedance 2.5 or WAN 3.0 for video.

Example Outputs

Real outputs generated by this model

Grok Image Edit example: a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelate...

View Details

a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."

1 credit

10.9s

View Details

1 credit

11.7s

View Details

1 credit

1049.8s

Code Examples

Basic edit (fast tier): copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/xai-image-edit/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "make it look like a watercolor painting",
    "image_url": "https://..."
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 1,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-30T11:03:10Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2026-10-30T11:03:10Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits

Grok Image Edit API

Get API Key

See Usage

Buy Credits

API Endpoint

Test This Model

LLM.txt

OpenAPI Spec

Parameters

Use saved characters (@Name)

See also

Example Outputs

Code Examples

Response Format

Submit Response (202 Accepted)

Completed Response