AI Photo Effects API

What is an AI Photo Effects API?

An AI photo effects API applies a predefined creative effect to an input image and returns the result. You pick the effect by name — "Angel Figurine", "1980s Decade", "Taj Mahal Landmark" — and the platform supplies the tuned prompt and settings behind it, so output is consistent and easy to automate.

Muapi offers three effects endpoints with a shared authentication scheme and submit-and-poll flow: AI Image Effects (18 viral looks such as figurines, comics and pixel characters), Nano Banana Effects (17 looks including decade styles, landmarks and famous-art scenes, with aspect-ratio control) and Flux Kontext Effects (13 edit-style effects such as age progression, hair change and background change). A single-style Ghibli endpoint is also available.

Photo Effects vs. Prompt-Based Image Editing

Photo effects are fixed, named looks: choose "3D Figurine" and get that style on any photo, every time. Prompt-based image editing is open-ended — you describe the change in words and results vary with the instruction. Use the effects API for repeatable templates, filter-style features and viral formats; use an image-editing model when you need a bespoke edit. Compare with the AI Image Editing API →

Key Capabilities

All Supported Photo Effects

Every preset below can be passed as the name parameter on its endpoint. Names are case-sensitive — copy them exactly as shown.

Getting the Best Results

• Use a clear, well-lit photo. A sharp subject with clean lighting transfers into effects such as figurines and comics far better than a blurry or dark image.
• Match the effect to the photo. Portrait effects expect a visible person; landmark and decade effects work best with full-body or well-framed shots.
• Pick the endpoint that fits. Use Nano Banana Effects for aspect-ratio control, AI Image Effects for the cheapest viral looks, and Flux Kontext Effects for edit-style changes.
• Expect some iteration. Like every generative model, results vary run to run — treat the first output as a draft and re-run with a cleaner source image if needed.

Privacy and Consent

Photo effects generate a likeness-based image of whoever appears in the photo. Only submit photos of people who have agreed to be used this way, and do not use effects to create misleading content about a real person. Muapi does not verify consent on your behalf; that responsibility sits with the API caller.

How to Call the Photo Effects API

1. Host your image. Upload it via POST /api/v1/upload_file or use any publicly reachable URL.
2. Submit the request. Call POST /api/v1/image-effects with image_url and name (the effect). nano-banana-effects adds an optional aspect_ratio; flux-kontext-effects also requires a prompt.
3. Poll for completion. Check GET /api/v1/predictions/{request_id}/result until status is completed, then download the image, or set a webhook to be notified.

curl -X POST https://api.muapi.ai/api/v1/image-effects \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "name": "Angel Figurine"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/image-effects",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "image_url": "https://example.com/photo.jpg",
        "name": "Angel Figurine",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

Frequently Asked Questions