| name | grok-imagine |
| description | Generate or edit images using a Grok-compatible image API. Use when the user asks to create, draw, edit, or design images, illustrations, logos, or visual content. Chinese triggers: 画, 生成图片, 做图, 画一个, 设计, 图片, 插图, 配图, 头像, logo. |
Prerequisites
Set these environment variables:
GROK_API_BASE — Your Grok-compatible API endpoint (e.g., http://localhost:8100/v1)GROK_API_KEY — Your API key
Instructions
Generate image for: $ARGUMENTS
Image Generation
curl -s ${GROK_API_BASE}/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${GROK_API_KEY}" \
-d '{
"model": "grok-imagine-1.0",
"prompt": "IMAGE_DESCRIPTION",
"n": 1,
"size": "1024x1024"
}'
The response contains image URLs in .data[].url. Download and show to user.
Image Editing
curl -s ${GROK_API_BASE}/images/edits \
-H "Authorization: Bearer ${GROK_API_KEY}" \
-F "model=grok-imagine-1.0-edit" \
-F "prompt=EDIT_DESCRIPTION" \
-F "image=@/path/to/image.png"
Models
- grok-imagine-1.0 — standard quality generation
- grok-imagine-1.0-fast — faster, lower quality
- grok-imagine-1.0-edit — edit existing images
Size Options
Common sizes: 1024x1024, 1024x1792, 1792x1024
Notes
- If you get "rate_limit_exceeded", the quota is temporarily exhausted. Wait and retry.
- If you get "blocked", the prompt may have triggered content filters. Try rephrasing.
- Generated image URLs are temporary. Download important images to local storage.
