image:pix-to-pix

Edit an image using a natural language instruction (instruction-based image-to-image).

Type: Async

Usage

Bash

simplified image:pix-to-pix --url <image-url> --prompt <instruction> [--wait]

Options

Flag	Type	Required	Description
--url	string	✅	Public URL of the source image
--prompt	string	✅	Editing instruction in natural language
--wait	boolean		Block until complete (timeout: 120s)

Example

Bash

simplified image:pix-to-pix \
  --url "https://example.com/photo.jpg" \
  --prompt "make it look like a watercolor painting" \
  --wait

Response (with --wait)

JSON

{ "url": "https://cdn.simplified.com/edited.png" }