Magic Hour Changelog: 2024
December 2024
File URL Support for Face Swap Video and Photo APIs.
To make it easier to use input files, we now allow file URLs for image_file_path and video_file_path in the following APIs:
POST /v1/face-swap
POST /v1/face-swap-photo
Simply pass the url in the file_path inputs:
{
"image_file_path": "https://cdn.yourwebsite.com/files/image.png",
"video_file_path": "https://cdn.yourwebsite.com/files/video.mp4"
}Increased Video Download URL Expiration
In the response of GET /v1/video-projects/:id, the expiration time is increased from 1 hour to 24 hours.
The GET /v1/image-projects/:id was already returning 24 hours expiration, so this change make both of these APIs have matching behavior.
Added `.downloads` key to `GET /v1/video-projects/:id`
Added .downloads key to GET /v1/video-projects/:id
In the response of GET /v1/video-projects/:id, we added .downloads key to return a list of output urls. This make video and image project response have matching behavior so it's easier to work with both APIs.
Note: The .download key is still part of the response to ensure backwards compatibility.
{
- "download": {
- "url": "https://videos.magichour.ai/id/output.mp4?auth-token=1234",
- "expires_at": "2024-12-18T00:00:00.000Z"
- },
+ "downloads": [
+ {
+ "url": "https://videos.magichour.ai/id/output.mp4?auth-token=1234",
+ "expires_at": "2024-12-18T00:00:00.000Z"
+ }
+ ],
}Added Image Background Remover API
Now you can remove background from your images via API. Get started with this new API using:
Launching Image Background Remover!
Head over to Image Background Remover to create yours today!

We also launched a free tool to the Image Background Remover Product Page so you can try out the new product for free!

Add Animation to API
Now you can create stop-motion animations via API. Get started with this new API using:
Note: Fun Fact: Animation was the first mode we built on Magic Hour!
Error Visibility on Errors
Previously, whenever an error occurred on generation, there's no additional details on why.
We now added an error key to the GET /v1/image-projects/:id and GET /v1/video-projects/:id APIs to give you deeper visibility into what happened.
{
"error": {
"code": "<error code>",
"message": "<explanation of error>"
}
}If you see unknown_error as the code, please reach out to our team at support@magichour.ai to debug further.
Delete Image/Video Project APIs
After you downloaded the output, you now can delete the generated asset from our storage. This is a highly requested feature from our API users to improve privacy for the end user.
Now you can call
DELETE /v1/image-projects/:id
DELETE /v1/video-projects/:idThis change is also released to all SDKs.