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 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 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 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",
},
)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
Seconds of Video Per Month
100 seconds
seconds
Recommended plan
Pro Annual
$300
/year
300,000 credits per year
Up to 3.5 hours of video
Up to 30,000 images
PRO ANNUAL covers your usage
- 24,000credits / month
- 25,000credits / month
- 1,000credits / 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.
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.
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.
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 Talking Photo. 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.