Face Editor API for Developers
AI Face Editor API
Apply tasteful retouching, relighting, or expression tweaks while keeping identity consistent.
Free credits on signup
Transparent per-credit pricing
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 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,
},
)Estimate Your API Costs
Build with model-specific APIs for video, image generation, and image editing. Compare inputs, examples, and capabilities across Magic Hour's supported models.
Pricing tier options
Images Per Month
10 images
images
Recommended plan
Creator Annual
$120
/year
120,000 credits per year
Up to 1.4 hours of video
Up to 12,000 images
PRO ANNUAL covers your usage
- 500credits / month
- 25,000credits / month
- 24,500credits / month
Estimated usage
Included
Remaining headroom
TOTAL BILL
$300
/year
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.
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.
Magic Hour offers subscription plans starting at $15/month (Creator), $39/month (Pro), and $99/month (Business), each including a monthly credit allotment. Credits are consumed per generation based on output length and model. You can also contact us to set up usage-based (pay-as-you-go) pricing. A free tier with credits is available on signup — no credit card required.
Sign up at magichour.ai/developer — no credit card required. You'll receive free credits and an API key immediately. The key works across all Magic Hour API endpoints including AI Face Editor. Start making API calls in minutes using our Python, Node.js, Go, or Rust SDKs.
Yes. Every new Magic Hour account gets free credits on signup that work across all API endpoints. No credit card is required to get started. Paid plans unlock higher credit limits, higher concurrency, and commercial use rights.