Face Expression Change API: AI Image Editing

Face Expression Change API Reference

Endpoint

POST https://api.muapi.ai/api/v1/face-expression-change

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
images_list	array	Yes	Upload or provide image urls.
aspect_ratio	string	No	Aspect ratio of generated image.Options: 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 21:9, 9:21Default: "1:1"
rotate_right_left	int	No	Rotate camera left (positive) or right (negative) in degrees. Positive values rotate left, negative values rotate right.Default: 0
move_forward	int	No	Move camera forward (0=no movement, 10=close-up)Default: 0
vertical_angle	int	No	Adjust vertical camera angle (-1=bird's eye view/looking down, 0=neutral, 1=worm's-eye view/looking up)Default: 0
wide_angle_lens	boolean	No	Enable wide-angle lens effectDefault: false
output_format	string	No	Format of the output image.Options: jpeg, png, webpDefault: "jpeg"

cURL example

REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/face-expression-change \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images_list":[]}' | 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}/face-expression-change", headers=headers, json={"images_list":[]})
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.