Magic Hour Changelog: 2025
February 2025
Multi Face Swap Just Got Better! 🚀
We've improved our Multi Face Swap mode — now with 2.5x faster processing and higher quality!
Added `.m4v` File Support
Added .m4v File Support
All APIs and web UIs now allows files with .m4v extension. All SDKs are updated to reflect this change.
Customizable Caption Templates! 🎉
We've added customization options to give you control over your subtitles appearance. You can now customize:
Text color, text highlight color, and Text border color.
Vertical and horizontal position.

Try it now: Auto Subtitle Generator
Animation and Video-to-Video APIs Now Allow File URLs.
To make it easier to use input files, we have now updated final two endpoints to support file urls for input files:
POST /v1/animationPOST /v1/video-to-video
Now, you won't have to upload files to our storage first before calling these two APIs.
POST /v1/video-to-video
res = client.v1.video_to_video.create(
assets={
"video_source": "file",
"video_file_path": "https://cdn.yourwebsite.com/files/video.mp4"
}
) const res = await client.v1.videoToVideo.create({
assets: {
videoSource: "file",
videoFilePath: "https://cdn.yourwebsite.com/files/video.mp4",
},
}); res, err := client.V1.VideoToVideo.Create(video_to_video.CreateRequest{
Assets: types.PostV1VideoToVideoBodyAssets{
VideoSource: types.PostV1VideoToVideoBodyAssetsVideoSourceEnumFile,
VideoFilePath: nullable.NewValue("https://cdn.yourwebsite.com/files/video.mp4"),
},
}) let res = client.v1().video_to_video().create(magic_hour::resources::v1::video_to_video::CreateRequest {
assets: magic_hour::models::PostV1VideoToVideoBodyAssets {
video_source: magic_hour::models::PostV1VideoToVideoBodyAssetsVideoSourceEnum::File,
video_file_path: Some("https://cdn.yourwebsite.com/files/video.mp4".to_string()),
},
);POST /v1/animation
res = client.v1.animation.create(
assets={
"audio_source": "file",
"audio_file_path": "https://cdn.yourwebsite.com/files/audio.mp3",
"image_file_path": "https://cdn.yourwebsite.com/files/image.png",
},
) const res = await client.v1.animation.create({
assets: {
audioSource: "file",
audioFilePath: "https://cdn.yourwebsite.com/files/audio.mp3",
imageFilePath: "https://cdn.yourwebsite.com/files/image.png",
},
}); res, err := client.V1.Animation.Create(animation.CreateRequest{
Assets: types.PostV1AnimationBodyAssets{
AudioSource: types.PostV1AnimationBodyAssetsAudioSourceEnumFile,
AudioFilePath: nullable.NewValue("https://cdn.yourwebsite.com/files/audio.mp3"),
ImageFilePath: nullable.NewValue("https://cdn.yourwebsite.com/files/image.png"),
},
}) let res = client.v1().animation().create(magic_hour::resources::v1::animation::CreateRequest {
assets: magic_hour::models::PostV1AnimationBodyAssets {
audio_file_path: Some("https://cdn.yourwebsite.com/files/audio.mp3".to_string()),
audio_source: magic_hour::models::PostV1AnimationBodyAssetsAudioSourceEnum::File,
image_file_path: Some("https://cdn.yourwebsite.com/files/image.png".to_string()),
},
);All of our APIs now supports file URLs!
Generate Subtitle for 3+ Minutes Videos
We added the Auto Subtitle Generator to our dashboard! The max duration of our current tool is 30 seconds. We have now expanded the max to 10,000 frames. This means you can generate videos of length:
6.9 minutes at 24fps
5.5 minutes at 30fps

Try it now: Auto Subtitle Generator
Added `high_quality` Param to Image-to-Video API
Added high_quality Param to Image-to-Video API
We previously introduced a High Quality checkbox to the web app. Now, our API supports high quality generation as well. As a quick recap, "High Quality" is better at detail preservation, ideal for humans and complex images.
Watch the before-and-after video
To use high quality mode, simply add .style.high_quality param when calling the API.
{
"style": {
+ "high_quality": true
}
}File URL Support for 5 different APIs.
To make it easier to work with input files, we added support for file urls for the following APIs:
POST /v1/ai-headshot-generator
POST /v1/ai-image-upscaler
POST /v1/image-background-remover
POST /v1/image-to-video
POST /v1/lip-sync
Now you don't have to upload the file to Magic Hour storage first before using the asset in the APIs. Simply use the url in the file_path inputs:
{
"audio_file_path": "https://cdn.yourwebsite.com/files/audio.mp3",
"image_file_path": "https://cdn.yourwebsite.com/files/image.png",
"video_file_path": "https://cdn.yourwebsite.com/files/video.mp4"
}Launching Usage-Based Pricing for API users
Benefits:
✅ Pay only for what you use
✅ Volume discounts—up to 50% off
✅ Never run out of frames
For example, 15,000 frames now costs just \$18 on our Creator tier instead of \$27 with a subscription.

If you're interested in our new pricing, send us an email at support@magichour.ai.
Detailed Usage Cost Breakdown + Usage Analytics
For users who has an active usage-based pricing subscription, we added detailed breakdown of cost based on each usage tier in your Developer Hub

Plus, get detailed analytics on your usage:

Added More Error Codes For More Visibility
We added 4 more API error codes to help you identify why a particular render failed. You can get the error details using the GET /v1/image-projects/:id and GET /v1/video-projects/:id endpoints by accessing .error.code and .error.message fields.
| Error Code | Error Message | | :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | | invalid_audio_file | The audio file contains invalid data. Please try a different file. | | invalid_image_file | The image file contains invalid data. Please try a different file. | | invalid_video_file | The video file contains invalid data. Please try a different file. | | invalid_youtube_url | The youtube video cannot be downloaded. The video may be private, age-restricted, or region-restricted. Please try a different url. |
Added AI Clothes Changer API
AI Clothes Changer is now available via API! Get started with this new API using: