Edit images with Add Image Watermark via the Muapi REST API. Pay per generation — no subscription needed.
POST https://api.muapi.ai/api/v1/add-image-watermarkSubmit a job with your MuApi API key in the x-api-key header, then poll https://api.muapi.ai/api/v1/predictions/{request_id}/result until status is completed.
| Name | Type | Required | Description |
|---|---|---|---|
| image_url | string | Yes | URL of the input image. |
| watermark_image_url | string | Yes | URL of the watermark image (PNG with transparency recommended) |
| position | string | No | Position of the watermark on the imageOptions: top-left, top-right, bottom-left, bottom-right, centerDefault: "bottom-right" |
| opacity | int | No | Watermark transparency (0 = invisible, 1 = fully opaque)Default: 0.7 |
| scale | int | No | Watermark size relative to video (0.1 = 10%, 1.0 = 100%)Default: 0.15 |
REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/add-image-watermark \
-H "x-api-key: $MUAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url":"https://example.com/your-image_url","watermark_image_url":"https://example.com/your-watermark_image_url"}' | jq -r .request_id)
curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY"import os, time, requests
API = "https://api.muapi.ai/api/v1"
headers = {"x-api-key": os.environ["MUAPI_API_KEY"]}
r = requests.post(f"{API}/add-image-watermark", headers=headers, json={"image_url":"https://example.com/your-image_url","watermark_image_url":"https://example.com/your-watermark_image_url"})
request_id = r.json()["request_id"]
while True:
res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json()
if res["status"] == "completed":
print(res["outputs"]); break
if res["status"] == "failed":
raise RuntimeError(res.get("error"))
time.sleep(3)Full docs and agent/MCP integration: llms.txt. Get an API key at muapi.ai/access-keys.