Talking Photo API for Developers
Talking Photo API
Drive a still portrait with speech audio—ideal for personalized outreach, digital humans, and lightweight video content.
Free to start
No watermarks on paid plans
Subscription or usage-based
Auto-scaling
Trusted by teams at
Everything You Need to Ship Talking Photo
Single-image animation with audio sync, generation modes, and timing controls for trustworthy delivery.
Portrait Animation
Animate a face from a photo using uploaded speech while preserving likeness within mode constraints.
Audio-Driven Performance
Use the same audio pipelines as other video tools—upload, reference file paths, and trim precisely.
Creative Modes
Tune generation_mode and related style fields to balance realism versus expressive motion.
Fast Generation
Great for outbound campaigns and app onboarding flows that need quick personalized clips.
Auto-Scaling Infrastructure
Scale fan-out jobs when thousands of users generate clips at once.
Commercial-Ready
Paid tiers support polished, non-watermarked exports for customer-facing products.
Integrate in 3 Steps
Ship personalized talking head experiences from a photo plus audio.
1
Get Your API Key
Sign up free and generate an API key from the Developer dashboard. You get free credits to start.
2
Pair Image & Audio
Upload portrait and audio files, set start/end seconds, and POST to the AI talking photo endpoint.
3
Get Results & Scale
Receive the swapped output via response or webhook. Deploy to production — infrastructure scales automatically.
Code Examples
Talking Photo 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_talking_photo.generate(
name="My Talking Photo",
start_seconds=0,
end_seconds=15,
assets={
"image_file_path": "/path/to/portrait.png",
"audio_file_path": "/path/to/voice.mp3",
},
)SDKs for Every Stack
Official open-source SDKs with full TypeScript/type support. Install and start building.
Talking Photo 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 Talking Photo API to power real products.
Sales & Outreach
Send prospects personalized video messages narrated by synthetic or recorded audio.
Social & Meme Apps
Let users make talking memes from selfies with minimal UI surface area.
E-Commerce
Animate founder photos or mascots for launches and loyalty campaigns.
Media Kits
Produce lightweight host segments without full video shoots.
Games & Avatars
Give NPC portraits audible lines for narrative moments.
Education
Turn instructor photos into announcement clips for LMS platforms.
Try before integrating
Try Talking Photo 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.
Talking Photo API — Frequently Asked Questions
It is a video generated from a still portrait plus audio, with facial motion synchronized to the soundtrack.
Use POST /v1/ai-talking-photo with assets referencing uploaded image and audio file paths.
Duration is constrained by start_seconds, end_seconds, and plan maximums documented on Magic Hour.
Yes. Pass generation_mode and related style parameters supported by the API for realism or expressiveness.
Results vary with photo quality, lighting, and mode—validate with your own content samples.
Magic Hour processes assets per its data handling policies; check security docs for retention details.
Official Python and Node SDKs expose ai_talking_photo / aiTalkingPhoto helpers.
Track video project status via the standard Magic Hour project polling or webhook integrations.