#sidebar,
#table-of-contents-content {
  scrollbar-gutter: stable;
  scrollbar-width: thin;
  scrollbar-gutter: none;
  scrollbar-color: gray transparent;
}


Animation

Face Swap

Image to Video

Lip Sync

Text-to-Video

Video-to-Video

APIs coming soon

Available video tools you can integrate in your application.

Video Tools

Easily generate videos using Magic Hour's API. Follow our documentation to seamlessly integrate video creation into your applications.

Magic Hour API

Transform your apps with Magic Hour's AI-powered video and image generation API.

API Documentation | Magic Hour

Introduction

Generate your first image and video in minutes

Quick Start

Available image tools you can integrate in your application.

Image Tools

Learn how to fully integrate APIs into your own application.

Adding API to Your App

Input Files

Learn about available subscription options.

Billing Overview

See what usage-based pricing has to offer.

Usage Based Pricing

See what prepaid subscription has to offer.

Prepaid Subscription

Create a list of urls used to upload the assets needed to generate a video. Each video type has their own requirements on what assets are required. Please refer to the specific mode API for more details. The response array will be in the same order as the request body.

Below is the list of valid extensions for each asset type:

- video: mp4, m4v, mov, webm
- audio: mp3, mpeg, wav, aac, aiff, flac
- image: png, jpg, jpeg, webp, avif, jp2, tiff, bmp

Note: `.gif` is supported for face swap API `video_file_path` field.

After receiving the upload url, you can upload the file by sending a PUT request with the header `'Content-Type: application/octet-stream'`.

For example using curl

```
curl -X PUT -H 'Content-Type: application/octet-stream' \
  --data '@/path/to/file/video.mp4' \
  https://videos.magichour.ai/api-assets/id/video.mp4?auth-value=1234567890
```


Upload Asset URLs

Get the details of a video project. The `downloads` field will be empty unless the video was successfully rendered.

The video can be one of the following status
- `draft` - not currently used
- `queued` - the job is queued and waiting for a GPU
- `rendering` - the generation is in progress
- `complete` - the video is successful created
- `error` - an error occurred during rendering
- `canceled` - video render is canceled by the user


Get video details

Permanently delete the rendered video. This action is not reversible, please be sure before deleting.

Delete video

Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.

Create a Face Swap video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
  
Get more information about this mode at our [product page](/products/face-swap).
  

Face Swap video

Create a Image To Video video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
  
Get more information about this mode at our [product page](/products/image-to-video).
  

Image-to-Video

Create a Lip Sync video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
  
Get more information about this mode at our [product page](/products/lip-sync).
  

Create a Video To Video video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
  
Get more information about this mode at our [product page](/products/video-to-video).
  

Create a Text To Video video. The estimated frame cost is calculated using 30 FPS. This amount is deducted from your account balance when a video is queued. Once the video is complete, the cost will be updated based on the actual number of frames rendered.
  
Get more information about this mode at our [product page](/products/text-to-video).
  

Get the details of a image project. The `downloads` field will be empty unless the image was successfully rendered.

The image can be one of the following status
- `draft` - not currently used
- `queued` - the job is queued and waiting for a GPU
- `rendering` - the generation is in progress
- `complete` - the image is successful created
- `error` - an error occurred during rendering
- `canceled` - image render is canceled by the user


Get image details

Permanently delete the rendered image. This action is not reversible, please be sure before deleting.

Delete image

Change outfits in photos in seconds with just a photo reference. Each photo costs 25 frames.

AI Clothes Changer

Create an AI headshot. Each headshot costs 50 frames.

AI Headshots

Create an AI image. Each image costs 5 frames.

AI Images

Upscale your image using AI. Each 2x upscale costs 50 frames, and 4x upscale costs 200 frames.

AI Image Upscaler

> **NOTE**: this API is still in early development stages, and should be avoided. Please reach out to us if you're interested in this API. 

Edit photo using AI. Each photo costs 10 frames.

AI Photo Editor

Create an AI QR code. Each QR code costs 20 frames.

AI QR Code

Create a face swap photo. Each photo costs 5 frames. The height/width of the output image depends on your subscription. Please refer to our [pricing](/pricing) page for more details

Get Started

Integration

Billing

Video Tools

Animation

Product Page

API Spec

Face Swap

Product Page

API Spec

Image to Video

Product Page

API Spec

Lip Sync

Product Page

API Spec

Text-to-Video

Product Page

API Spec

Video-to-Video

Product Page

API Spec

APIs coming soon

Auto Subtitles Generator

Get Started

Integration

Billing

​Animation

Product Page

API Spec

​Face Swap

Product Page

API Spec

​Image to Video

Product Page

API Spec

​Lip Sync

Product Page

API Spec

​Text-to-Video

Product Page

API Spec

​Video-to-Video

Product Page

API Spec

​APIs coming soon

Auto Subtitles Generator

Animation

Face Swap

Image to Video

Lip Sync

Text-to-Video

Video-to-Video

APIs coming soon