Step 1: Initial Request (get Invoice)

Send your editing instructions and base64 image. You will receive a 402 Payment Required response with a Lightning invoice.

Request body:

{
  "prompt": "Change the jacket to red leather, keep the face and pose unchanged",
  "image": "<base64-encoded-image>",
  "aspect_ratio": "match_input_image",
  "output_format": "png"
}

Example curl command:

curl -X POST https://sats4ai.com/api/l402/edit-image \
-H "Content-Type: application/json" \
-d '{
  "prompt": "Change the jacket to red leather, keep the face and pose unchanged",
  "image": "<base64-encoded-image>",
  "aspect_ratio": "match_input_image",
  "output_format": "png"
}' \
-i

Expected response headers:

www-authenticate: L402 macaroon="<YOUR_MACAROON>", invoice="<LIGHTNING_INVOICE>"

Step 2: Pay the Lightning Invoice

Pay the invoice with any Lightning wallet (Phoenix, Muun, Alby, Wallet of Satoshi, etc.). Save the preimage your wallet provides after payment.

Step 3: Re-send with Payment Proof

Send the exact same request again with the Authorization header.

The JSON payload must be identical to Step 1.

curl -X POST https://sats4ai.com/api/l402/edit-image \
-H "Content-Type: application/json" \
-H "Authorization: L402 <YOUR_MACAROON>:<YOUR_PREIMAGE>" \
-d '{
  "prompt": "Change the jacket to red leather, keep the face and pose unchanged",
  "image": "<base64-encoded-image>",
  "aspect_ratio": "match_input_image",
  "output_format": "png"
}'

Successful response includes image_url (URL to edited image — download promptly).

Easier: Use lnget

lnget handles the full L402 flow automatically — invoice, payment, and re-request in one command.

# Encode your image first
IMAGE_B64=$(base64 -w0 photo.png)

lnget -X POST https://sats4ai.com/api/l402/edit-image \
  --json "{\"prompt\":\"Remove the parked car on the left, keep everything else as it is\",\"image\":\"$IMAGE_B64\",\"output_format\":\"png\"}"

Python Example

import requests, base64

# Encode image
with open("photo.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

payload = {
    "prompt": "Change the jacket to red leather, keep the face and pose unchanged",
    "image": image_b64,
    "aspect_ratio": "match_input_image",
    "output_format": "png"
}

# Step 1 — get invoice
r = requests.post("https://sats4ai.com/api/l402/edit-image",
    json=payload,
    headers={"Content-Type": "application/json"})
# r.status_code == 402
# Parse macaroon and invoice from r.headers["www-authenticate"]

# Step 2 — pay invoice with your Lightning wallet, get preimage

# Step 3 — re-send with auth
r2 = requests.post("https://sats4ai.com/api/l402/edit-image",
    json=payload,
    headers={
        "Content-Type": "application/json",
        "Authorization": "L402 <macaroon>:<preimage>"
    })
result = r2.json()
print(result["image_url"])  # URL to edited image (download promptly)

Request Parameters

Pricing

Resolution-tiered pricing:

Use Cases

• Replace image backgrounds for product photos
• Apply style transfers or artistic effects to photos
• Remove unwanted objects from images
• Batch-edit images via script or agent without manual editing tools
• Need a genuine transparent cutout? Use remove-background — this endpoint returns an opaque image even with output_format: png