Face Editor API for Developers
AI Face Editor API
Adjust facial expressions, gaze, and head pose with explicit style parameters.
Free credits on signup
Transparent per-credit pricing
No watermarks with paid plans or credit packs
Subscriptions, credit packs, or usage-based billing
Auto-scaling
Trusted by teams at
Everything You Need to Ship AI Face Editor
Controlled facial edits for portrait apps and expression workflows.
Identity-Aware Edits
Adjust smiles, gaze, and head pose using documented face-editing parameters.
Detail Preservation
Maintains skin texture and hair detail better than heavy global filters.
Expression Controls
Control mouth, eyebrow, eye, and head settings with numeric parameters.
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 & Parameters
Upload the portrait and set style parameters such as mouth_smile, eye_gaze_horizontal, and head_yaw in increments of 5.
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.generate(
assets={"image_file_path": "/path/to/1234.png"},
style={
"enhance_face": False,
"eye_gaze_horizontal": 0.0,
"eye_gaze_vertical": 0.0,
"eye_open_ratio": 0.0,
"eyebrow_direction": 0.0,
"head_pitch": 0.0,
"head_roll": 0.0,
"head_yaw": 0.0,
"lip_open_ratio": 0.0,
"mouth_grim": 0.0,
"mouth_position_horizontal": 0.0,
"mouth_position_vertical": 0.0,
"mouth_pout": 0.0,
"mouth_purse": 0.0,
"mouth_smile": 0.0,
},
name="Face Editor image",
wait_for_completion=True,
download_outputs=True,
download_directory="."
)Estimate Your API Costs
Every generation uses credits. Prepay with a subscription or one-time credit packs, or request usage-based billing for monthly invoicing and volume discounts.
Pricing tier options
USD subscription prices. Image allowances use Z-Image Turbo at 1K (5 credits/image); video allowances use LTX-2.5 at 480p. These reference allowances do not describe every endpoint. Choose your tool, model, and settings below for its estimate.
Images Per Month
10 images
images
Recommended plan
Creator Yearly
$144
/year
144,000 credits per year
Up to 1.7 hours of video
Up to 28,800 images
Selected plan: Pro Yearly
PRO YEARLY 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.
Need usage-based billing?
Email us or message us in Intercom for monthly billing with graduated volume discounts.
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 in assets.image_file_path and a style object with the documented face-editing parameters.
Keep originals client-side; each API call returns a new rendered asset.
Magic Hour enforces acceptable-use policies—see trust & safety documentation.
Use client.v1.ai_face_editor.create in Python or client.v1.aiFaceEditor.create in Node. Use client.v1.ai_face_editor.generate / client.v1.aiFaceEditor.generate to upload local inputs and wait for results.
Higher resolutions take longer; poll the image job until success.
Paid subscriptions and credit-pack purchases include commercial-use rights. Users without either purchase are limited to personal, non-commercial use. 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 $19/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. One-time credit packs add credits without a subscription. Usage-based billing with graduated volume discounts is available by request. 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.
New accounts get free credits to test supported free-tier API endpoints. Some models and resolutions require a paid plan; check the current endpoint page and pricing before integrating.