Nano Banana Effects API: AI Image Editing

Nano Banana Effects API Reference

Endpoint

POST https://api.muapi.ai/api/v1/nano-banana-effects

Submit 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.

Parameters

Name	Type	Required	Description
image_url	string	Yes	URL of the input image.
name	string	No	The type of effect to apply to the image.Options: 3D Figurine, 16bit Game Character, 1920s Decade, 1950s Decade, 1970s Decade, 1980s Decade, Action Figure, American Gothic Art, Egypts Landmark, Eiffel Tower Landmark, Famous Art, Great Wall of China Landmark, Mona Lisa Art, Persistent Memory Art, Statue of Liberty Landmark, Taj Mahal Landmark, Vincent Van Gogh ArtDefault: "3D Figurine"
aspect_ratio	string	No	Aspect ratio of the output image.Options: Auto, 1:1, 3:4, 4:3, 9:16, 16:9, 3:2, 2:3, 5:4, 4:5, 21:9Default: "Auto"

cURL example

REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/nano-banana-effects \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/your-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"

Python example

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}/nano-banana-effects", headers=headers, json={"image_url":"https://example.com/your-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.