Headshot Generator API for Developers
AI Headshot Generator API
Upload a selfie, receive studio-style portraits—ideal for directories, badges, and profile onboarding.
Free to start
No watermarks on paid plans
Subscription or usage-based
Auto-scaling
Trusted by teams at
Everything You Need to Ship AI Headshot Generator
Style prompts and safety checks help teams scale consistent employer branding across hires.
Portrait Generation
Creates professional framing, lighting, and wardrobe cues from a single reference photo.
Brand-Ready Styles
Tune prompts and presets to align with corporate photography guidelines.
Consistent Sets
Generate multiple looks per employee for intranet, CRM, and conference apps.
Fast Processing
Onboarding flows can render headshots while users finish paperwork.
Auto-Scaling Infrastructure
Handle recruiting season spikes without resizing internal GPU pools.
Commercial-Ready
Paid tiers unlock polished assets suitable for customer-facing profiles.
Integrate in 3 Steps
Automate employer-branded portraits compliantly.
1
Get Your API Key
Sign up free and generate an API key from the Developer dashboard. You get free credits to start.
2
Upload a Source Portrait
Provide image_file_path from uploads and optional style prompt fields per the headshot schema.
3
Get Results & Scale
Receive the swapped output via response or webhook. Deploy to production — infrastructure scales automatically.
Code Examples
AI Headshot Generator 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_headshot_generator.generate(
name="Headshot",
assets={"image_file_path": "/path/to/selfie.jpg"},
)SDKs for Every Stack
Official open-source SDKs with full TypeScript/type support. Install and start building.
AI Headshot Generator 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 Headshot Generator API to power real products.
HR & Onboarding
Issue consistent directory photos for every new hire automatically.
Personal Branding
Help coaches, agents, and execs refresh LinkedIn imagery in-app.
Marketplaces
Normalize seller avatars for trust and safety teams.
Creator Platforms
Bundle headshot refresh perks into subscription tiers.
Casting Tools
Generate neutral portfolio frames for talent databases.
Games & Social
Offer stylized portraits for player profiles.
Try before integrating
Try AI Headshot Generator 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 Headshot Generator API — Frequently Asked Questions
Typically a single face-forward image path plus optional style parameters documented in the reference.
Use supported prompt or preset fields to bias wardrobe and backdrop toward brand standards.
Issue multiple jobs if you need several outfits; each job bills per the pricing table.
You must have rights to the source photo—embed consent in your onboarding UX.
Python and Node include ai_headshot_generator / aiHeadshotGenerator helpers.
Most jobs finish in seconds to a minute depending on resolution and queue depth.
Workspace features are documented separately—contact sales for enterprise controls.
docs.magichour.ai hosts the live schema for ai-headshot-generator.