Face Editor API for Developers
AI Face Editor API
Apply tasteful retouching, relighting, or expression tweaks while keeping identity consistent.
Free to start
No watermarks on paid plans
Subscription or usage-based
Auto-scaling
Trusted by teams at
Everything You Need to Ship AI Face Editor
Blend generative edits with portrait safety—great for beauty apps and corrective workflows.
Identity-Aware Edits
Adjust smiles, gaze, or cosmetics without uncanny full-face replacements.
Detail Preservation
Maintains skin texture and hair detail better than heavy global filters.
Creative Looks
Explore stylized makeup, lighting, and mood boards for entertainment products.
Fast Processing
Suitable for real-time preview flows with progressive refinement.
Auto-Scaling Infrastructure
Serve global user bases during events or viral filters.
Commercial-Ready
Deploy in paid photo suites with licensing aligned to production use.
Integrate in 3 Steps
Offer portrait AI safely inside your editor.
1
Get Your API Key
Sign up free and generate an API key from the Developer dashboard. You get free credits to start.
2
Send Portrait & Edit Instructions
Upload the base photo and supply prompt or parameter blocks defined for ai-face-editor.
3
Get Results & Scale
Receive the swapped output via response or webhook. Deploy to production — infrastructure scales automatically.
Code Examples
AI Face Editor in a few lines of code. Install an SDK or use the REST API directly.
from magic_hour import Client
from os import getenv
client = Client(token=getenv("MAGIC_HOUR_API_KEY"))
res = client.v1.ai_face_editor.edit(
name="Face Edit",
assets={"image_file_path": "/path/to/portrait.png"},
style={
"mouth_smile": 25,
"enhance_face": False,
"eye_gaze_horizontal": 0.0,
"eye_gaze_vertical": 0.0,
"eye_open_ratio": 0.0,
},
)SDKs for Every Stack
Official open-source SDKs with full TypeScript/type support. Install and start building.
AI Face Editor API Pricing
Subscription plans for standard usage.
Prefer usage-based pricing?
Email us or message us in Intercom and we will set up your usage-based pricing.
API Calculator
Use our calculator to estimate your API costs.
Tier
Estimated monthly cost
$1.73
Based on 24 FPS
Built for Builders
See how developers use the AI Face Editor API to power real products.
Photo Apps
Add pro retouch sliders backed by generative models.
Marketing Retouch
Batch polish talent photos for campaigns.
E-Commerce
Normalize model expressions across catalog reshoots.
Studios
Preview directing notes before expensive reshoots.
Avatars
Let players tweak emotions on portraits.
Healthcare Simulation
Train empathy scenarios with subtle expression changes (with consent).
Try before integrating
Try AI Face Editor Free — No Code Required
Test quality first with the free tool, then plug the same output quality into your app with the API when you are ready.
AI Face Editor API — Frequently Asked Questions
It performs controlled edits; you should disclose usage to end users and obtain consent.
Provide a portrait via image_file_path from Magic Hour uploads plus style instructions per docs.
Keep originals client-side; each API call returns a new rendered asset.
Magic Hour enforces acceptable-use policies—see trust & safety documentation.
Yes—ai_face_editor.edit / aiFaceEditor.edit in Python and Node.
Higher resolutions take longer; poll the image job until success.
Paid tiers are intended for production; confirm your contract for redistribution rights.
docs.magichour.ai lists every style key for ai-face-editor.