Latest feature enhancements in Magic Hour
v0.33.0
.face_mappings
parameter. This gives you more precise control over face swapping operations.To take advantage of the this change, please upgrade your sdk version to v0.32.0
.Note: v0.31.0
had a bug where the image_file_path
is still required even if you’re using face_swap_mode: individual-faces
. This has been fixed in v0.31.1
.GET /v1/face-detection/{id}
APIGET /v1/face-detection/{id}
API was always returning 401 Unauthorized. We have since fixed the issue and the API should now be working as expected.To take advantage of the this change, please upgrade your sdk version to v0.30.1
.POST /v1/face-detection
GET /v1/face-detection/{id}
faces
as soon as any face is detected.v0.30.0
.face_mappings
parameter. This gives you more precise control over face swapping operations.Example usage:v0.29.0
.Note: the original face path is part of the response from the face detection API [Coming soon]v0.28.0
.POST /v1/auto-subtitle-generator
APIPOST /v1/auto-subtitle-generator
API, which allows you to generate subtitles for your videos.To take advantage of the this change, please upgrade your sdk version to v0.27.0
.v0.26.0
.v0.25.0
.POST /v1/files/upload-urls
endpoint to not require Content-Type
header. This should simplify the upload process a bit, you’re welcome to pass in the content type of your file or leave it completely.POST /v1/ai-image-generator
endpoint.style.tool
to the API so you can pick a specific tool to use for the AI Image generator. We have over 30 tools available to help better customize the style of your output. See the list of tools available via: https://docs.magichour.ai/api-reference/image-projects/ai-images#body-style-toolTo take advantage of the this change, please upgrade your sdk version to 0.24.0
.Analytics & Billing
, API Keys
, and Webhooks
.Expressive
mode to Talking Photo, and now it has been added to the API as well. We also added a .style.intensity
param to help control amount of motion and expressiveness.To take advantage of the this change, please upgrade your sdk version to 0.23.0
.frames
to credit
in the API.frame
because we started off only having video modes, but since we now include images as well, using frame as the name of our credit system can cause confusion, so we renamed it.We introduced this change in sdk v0.22.0, and deprecated fields referencing frames
credits_charged
field in the API response for get details API and success responses from create API calls.total_frame_cost
from the GET /v1/video-projects/:id
API.estimated_frame_cost
from the success response in create video API.total_frame_cost
from the GET /v1/image-projects/:id
API.frame_cost
from the success response in create image API.0.22.0
.height
/width
optionalheight
and width
as required params for the POST /v1/video-to-video
API. We now will automatically figure out orientation of the output video based on the input video.To take advantage of the this change, please upgrade your sdk version to 0.20.0
.0.19.0
.height
and width
as required params for the POST /v1/image-to-video
API. We now will automatically figure out orientation of the output video based on the input image.To take advantage of the this change, please upgrade your sdk version to 0.18.0
.0.17.0
.height
and width
as required params for the POST /v1/lip-sync
API. We now will automatically figure out aspect ratio of the input video and resize based on your subscription’s maximum resolution. This makes it easier to create the video as you no longer need to figure out the aspect ratio of your input video and compute the height/width.We also released POST /v1/ai-face-editor
API.To take advantage of the this change, please upgrade your sdk version to 0.16.0
.height
and width
as required params for the POST /v1/face-swap
API. We now will automatically figure out aspect ratio of the input video and resize based on your subscription’s maximum resolution. This makes it easier to create the video as you no longer need to figure out the aspect ratio of your input video and compute the height/width.To take advantage of the this change, please upgrade your sdk version to 0.15.0
.Text-to-video
0.13.0
.POST /v1/ai-meme-generator
to our APIs and SDKs. Now you can create memes even faster!Check out API referenceGET /v1/video-projects/:id
and GET /v1/image-projects/:id
API type field is updated from enum to string field. This field is mainly used for internal filtering, and having the field being enum means any new mode we add becomes a breaking change. So we decided to introduce this breaking change once so we can more easily add new modes down the line.Previous | New | Improvement |
---|---|---|
10s | 30s | 3x |
GET /v1/video-projects
would return a 500 error when requesting a video project with type: TALKING_PHOTO
.0.12.0
to create AI Talking PhotoVersion | Time | Improvement |
---|---|---|
1.0 | ~18 seconds | — |
2.0 | ~43 seconds | 2.4x slower |
3.0 | ~6 seconds | 7.2x faster |
prompt
param to your request.0.10.0
to use custom prompt with AI Headshot Generator.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_path | The audio_file_path value provided does not point to a valid audio file. This value should be a valid URL or file_path from the API https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls. |
invalid_image_path | The image_file_path value provided does not point to a valid image file. This` value should be a valid URL or file_path from the API https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls. |
invalid_video_path | The video_file_path value provided does not point to a valid video file. This value should be a valid URL or file_path from the API https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls. |
Please use an image with a detectable model
or Please use an image with a detectable outfit
.Tool | Previous Time | New Time | Improvement |
---|---|---|---|
AI Headshot Generator | ~30 seconds | ~7 seconds | 4.3x faster |
Face Swap Photo | ~16 seconds | ~6 seconds | 2.5x faster |
.m4v
File Support.m4v
extension. All SDKs are updated to reflect this change.POST /v1/animation
POST /v1/video-to-video
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:high_quality
Param to Image-to-Video APIHigh 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..style.high_quality
param when calling the API.file_path
inputs: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. |