Image Processing

AI-powered image processing commands. All commands accept --url with a public image URL.

Async vs synchronous:

• Most commands are async — they return a task_id. Use --wait to block until complete, or poll manually with image:task.
• image:blur-background is synchronous — returns {"image_url": "..."} directly.

Commands

Command	Type	Description
image:remove-background	async	Remove image background
image:blur-background	sync	Blur image background
image:upscale	async	Upscale image up to 4x
image:convert	async	Convert to another format
image:generative-fill	async	AI generative fill with prompt
image:restore	async	Restore/enhance image quality
image:outpaint	async	Extend image canvas with AI
image:magic-inpaint	async	AI object removal/replacement
image:pix-to-pix	async	Instruction-based image editing
image:replace	async	Replace objects in image via prompt
image:sd-scribble	async	Generate image from sketch/scribble
image:task	—	Poll async task status

Async Workflow

Bash

# Without --wait: returns task_id immediately
simplified image:remove-background --url "https://example.com/photo.jpg"
# {"task_id": "abc123"}

# With --wait: blocks until done (timeout: 120s)
simplified image:remove-background --url "https://example.com/photo.jpg" --wait
# {"url": "https://cdn.simplified.com/result.png"}

# Manual poll
simplified image:task --id "abc123"
# status: pending | completed | success | failed