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


Quick start

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

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

API Documentation | Magic Hour

Introduction

Magic Hour API

Generate your first image and video in minutes

Quick Start

Available video tools you can integrate in your application.

Video Tools

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.

Animation

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).
  

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).
  

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).
  

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

Introduction

Quick start

Quick Start

API Reference

Get Started

Integration

Billing

​Quick start

Quick Start

API Reference

Quick start