# Magic Hour API Docs

> Easily generate videos, images, and audio using Magic Hour's API. Follow our documentation to seamlessly integrate AI content creation into your applications.

## Docs

- [AI Voice Cloner](https://docs.magichour.ai/api-reference/audio-projects/ai-voice-cloner.md): Clone a voice from an audio sample and generate speech.  * Each character costs 0.05 credits.  * The cost is rounded up to the nearest whole number
- [AI Voice Generator](https://docs.magichour.ai/api-reference/audio-projects/ai-voice-generator.md): Generate speech from text. Each character costs 0.05 credits. The cost is rounded up to the nearest whole number.
- [Delete audio](https://docs.magichour.ai/api-reference/audio-projects/delete-audio.md): Permanently delete the rendered audio file(s). This action is not reversible, please be sure before deleting.
- [Get audio details](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details.md): Check the progress of a audio project. The `downloads` field is populated after a successful render.    **Statuses** - `queued` — waiting to start - `rendering` — in progress - `complete` — ready; see `downloads` - `error` — a failure occurred (see `error`) - `canceled` — user canceled - `draft` — n…
- [Face Detection](https://docs.magichour.ai/api-reference/files/face-detection.md): Detect faces in an image or video.         Use this API to get the list of faces detected in the image or video to use in the [face swap photo](https://docs.magichour.ai/api-reference/image-projects/face-swap-photo) or [face swap video](https://docs.magichour.ai/api-reference/video-projects/face-swa…
- [Generate asset upload urls](https://docs.magichour.ai/api-reference/files/generate-asset-upload-urls.md): Generates a list of pre-signed upload URLs for the assets required. This API is only necessary if you want to upload to Magic Hour's storage. Refer to the [Input Files Guide](/integration/input-files) for more details.
- [Get face detection details](https://docs.magichour.ai/api-reference/files/get-face-detection-details.md): Get the details of a face detection task.
- [AI Clothes Changer](https://docs.magichour.ai/api-reference/image-projects/ai-clothes-changer.md): Change outfits in photos in seconds with just a photo reference. Each photo costs 25 credits.
- [AI Face Editor](https://docs.magichour.ai/api-reference/image-projects/ai-face-editor.md): Edit facial features of an image using AI. Each edit costs 1 frame. The height/width of the output image depends on your subscription. Please refer to our [pricing](https://magichour.ai/pricing) page for more details
- [AI GIF Generator](https://docs.magichour.ai/api-reference/image-projects/ai-gif-generator.md): Create an AI GIF. Each GIF costs 50 credits.
- [AI Headshot Generator](https://docs.magichour.ai/api-reference/image-projects/ai-headshot-generator.md): Create an AI headshot. Each headshot costs 50 credits.
- [AI Image Editor](https://docs.magichour.ai/api-reference/image-projects/ai-image-editor.md): Edit images with AI.
- [AI Image Generator](https://docs.magichour.ai/api-reference/image-projects/ai-image-generator.md): Create an AI image with advanced model selection and quality controls.
- [AI Image Upscaler](https://docs.magichour.ai/api-reference/image-projects/ai-image-upscaler.md): Upscale your image using AI. Each 2x upscale costs 50 credits, and 4x upscale costs 200 credits.
- [AI Meme Generator](https://docs.magichour.ai/api-reference/image-projects/ai-meme-generator.md): Create an AI generated meme. Each meme costs 10 credits.
- [AI QR Code Generator](https://docs.magichour.ai/api-reference/image-projects/ai-qr-code-generator.md): Create an AI QR code. Each QR code costs 0 credits.
- [Body Swap](https://docs.magichour.ai/api-reference/image-projects/body-swap.md): Swap a person into a scene image using Nano Banana 2. Credits depend on `resolution` (from 100 credits at 640px upward).
- [Delete image](https://docs.magichour.ai/api-reference/image-projects/delete-image.md): Permanently delete the rendered image(s). This action is not reversible, please be sure before deleting.
- [Face Swap Photo](https://docs.magichour.ai/api-reference/image-projects/face-swap-photo.md): Create a face swap photo. Each photo costs 10 credits. The height/width of the output image depends on your subscription. Please refer to our [pricing](https://magichour.ai/pricing) page for more details
- [Get image details](https://docs.magichour.ai/api-reference/image-projects/get-image-details.md): Check the progress of a image project. The `downloads` field is populated after a successful render.    **Statuses** - `queued` — waiting to start - `rendering` — in progress - `complete` — ready; see `downloads` - `error` — a failure occurred (see `error`) - `canceled` — user canceled - `draft` — n…
- [Head Swap](https://docs.magichour.ai/api-reference/image-projects/head-swap.md): Swap a head onto a body image. Each image costs 10 credits. Output resolution depends on your subscription; you may set `max_resolution` lower than your plan maximum if desired.
- [Image Background Remover](https://docs.magichour.ai/api-reference/image-projects/image-background-remover.md): Remove background from image. Each image costs 5 credits.
- [Photo Colorizer](https://docs.magichour.ai/api-reference/image-projects/photo-colorizer.md): Colorize image. Each image costs 10 credits.
- [AI Talking Photo](https://docs.magichour.ai/api-reference/video-projects/ai-talking-photo.md): Create a talking photo from an image and audio or text input.
- [Animation](https://docs.magichour.ai/api-reference/video-projects/animation.md): Create a Animation video. The estimated frame cost is calculated based on the `fps` and `end_seconds` input.
- [Auto Subtitle Generator](https://docs.magichour.ai/api-reference/video-projects/auto-subtitle-generator.md): Automatically generate subtitles for your video in multiple languages.
- [Delete video](https://docs.magichour.ai/api-reference/video-projects/delete-video.md): Permanently delete the rendered video. This action is not reversible, please be sure before deleting.
- [Face Swap Video](https://docs.magichour.ai/api-reference/video-projects/face-swap-video.md): **What this API does**
- [Get video details](https://docs.magichour.ai/api-reference/video-projects/get-video-details.md): Check the progress of a video project. The `downloads` field is populated after a successful render.    **Statuses** - `queued` — waiting to start - `rendering` — in progress - `complete` — ready; see `downloads` - `error` — a failure occurred (see `error`) - `canceled` — user canceled - `draft` — n…
- [Image-to-Video](https://docs.magichour.ai/api-reference/video-projects/image-to-video.md): **What this API does**
- [Lip Sync](https://docs.magichour.ai/api-reference/video-projects/lip-sync.md): **What this API does**
- [Text-to-Video](https://docs.magichour.ai/api-reference/video-projects/text-to-video.md): **What this API does**
- [Video-to-Video](https://docs.magichour.ai/api-reference/video-projects/video-to-video.md): **What this API does**
- [Pricing Overview](https://docs.magichour.ai/billing/overview.md): Choose the right pricing model for your needs - subscription or usage-based billing.
- [Resolution Limits](https://docs.magichour.ai/billing/resolution-limits.md): Maximum resolution limits for each subscription tier and tool across all Magic Hour APIs.
- [Subscription Pricing](https://docs.magichour.ai/billing/subscription-pricing.md): Get credits upfront with predictable monthly or yearly billing and bonus credits for annual plans.
- [Usage-Based Pricing](https://docs.magichour.ai/billing/usage-based-pricing.md): Pay only for what you use with automatic monthly billing and volume discounts.
- [2026](https://docs.magichour.ai/changelog.md): Latest feature enhancements in Magic Hour
- [2023](https://docs.magichour.ai/changelog/2023.md): List of feature releases in 2023
- [2024](https://docs.magichour.ai/changelog/2024.md): List of feature releases in 2024
- [2025](https://docs.magichour.ai/changelog/2025.md): Latest feature enhancements in Magic Hour
- [Authentication](https://docs.magichour.ai/get-started/authentication.md): Create and manage API keys to authenticate your requests to the Magic Hour API.
- [API Cookbook - Google Colab](https://docs.magichour.ai/get-started/cookbook.md): Try all 22 Magic Hour APIs with ready-to-run sample code.
- [Quick Start](https://docs.magichour.ai/get-started/quick-start.md): Generate an API key and make your first call in <3 minutes.
- [Development and Testing](https://docs.magichour.ai/integration/development-and-testing.md): Best practices for developing and testing your Magic Hour API integration without consuming credits.
- [Creating Your First Integration](https://docs.magichour.ai/integration/first-integration.md): Build a complete Magic Hour integration from scratch in this hands-on tutorial.
- [Handling Inputs and Outputs](https://docs.magichour.ai/integration/inputs-and-outputs.md): Complete guide to uploading input files and downloading generated results from Magic Hour API.
- [MCP Server](https://docs.magichour.ai/integration/model-context-protocol.md): Access Magic Hour API docs through your favorite AI tools
- [Integration Overview](https://docs.magichour.ai/integration/overview.md): Understand how the Magic Hour API works and how to integrate it into your application.
- [Create a Webhook](https://docs.magichour.ai/integration/webhook/create-webhook.md): Set up and test your first webhook end-to-end to receive real-time notifications from Magic Hour.
- [Webhook Event Types](https://docs.magichour.ai/integration/webhook/event-types.md): Complete reference of all webhook events, payloads, and when they're triggered.
- [Securing Your Webhook Handler](https://docs.magichour.ai/integration/webhook/secure-handler.md): Verify webhook authenticity with HMAC-SHA256 signature validation to prevent malicious requests.
- [Welcome to Magic Hour API](https://docs.magichour.ai/introduction.md): Magic Hour API documentation - generate videos, images, and audio using AI.
- [AI Voice Cloner Tool - Magic Hour Docs](https://docs.magichour.ai/tools/audio/voice-cloner.md): Clone any voice and generate realistic speech audio from text using custom voice samples.
- [AI Voice Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/audio/voice-generator.md): Generate realistic speech audio from text using celebrity and character voices.
- [Image Background Remover Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/background-remover.md): Automatically remove backgrounds from images with precision edge detection.
- [AI Clothes Changer Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/clothes-changer.md): Virtually try on different clothing items with realistic results.
- [AI Face Editor Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/face-editor.md): Edit and enhance facial features with AI-powered precision and natural results.
- [Face Swap Photo Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/face-swap-photo.md): Replace faces in photos with realistic precision and natural blending.
- [AI GIF Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/gif-generator.md): Create animated GIFs from images or text prompts with AI-powered generation.
- [AI Headshot Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/headshot-generator.md): Generate professional-quality headshots from a single photo.
- [AI Image Editor Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/image-editor.md): Edit and modify images with AI-powered tools for comprehensive image manipulation.
- [AI Image Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/image-generator.md): Create high-quality images from text descriptions using AI.
- [AI Image Upscaler Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/image-upscaler.md): Enhance image resolution and quality using AI-powered upscaling.
- [AI Meme Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/meme-generator.md): Create AI-generated memes using popular templates and custom topics.
- [Photo Colorizer Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/photo-colorizer.md): Colorize black and white photos with AI-powered realistic color restoration.
- [AI QR Code Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/image/qr-code-generator.md): Create visually appealing, artistic QR codes that maintain functionality.
- [Animation Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/animation.md): Transform static images into dynamic animated videos with smooth motion.
- [Auto Subtitle Generator Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/auto-subtitle-generator.md): Automatically generate and embed subtitles in videos with AI-powered transcription.
- [Face Swap Video Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/face-swap-video.md): Replace faces in videos with frame-by-frame precision and temporal consistency.
- [Image to Video Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/image-to-video.md): Convert static images into dynamic video content with AI-generated motion.
- [Lip Sync Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/lip-sync.md): Synchronize lip movements in videos with new audio tracks.
- [AI Talking Photo Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/talking-photo.md): Animate static photos to speak with realistic lip-sync and facial movements.
- [Text to Video Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/text-to-video.md): Generate complete video content from text descriptions using AI.
- [Video to Video Tool - Magic Hour Docs](https://docs.magichour.ai/tools/video/video-to-video.md): Transform existing videos by applying new styles, effects, and visual treatments.
- [Audio Completed](https://docs.magichour.ai/webhook-reference/audio-events/audio-completed.md): Magic Hour notifies your server when an audio generation completes successfully. Payload covers downloads, credits, duration, and how to verify the incoming signed request.
- [Audio Errored](https://docs.magichour.ai/webhook-reference/audio-events/audio-errored.md): Magic Hour notifies your server when an audio project fails. Error-focused webhook reference with request headers, body fields, and examples for your failure-handling logic.
- [Audio Started](https://docs.magichour.ai/webhook-reference/audio-events/audio-started.md): Magic Hour notifies your server when an audio project begins processing. Webhook reference for timestamp and signature headers plus JSON body for voice and audio jobs.
- [Image Completed](https://docs.magichour.ai/webhook-reference/image-events/image-completed.md): Magic Hour notifies your server when an image project completes. Reference download arrays, credits, image count, project type, and verified request shape for integrations.
- [Image Errored](https://docs.magichour.ai/webhook-reference/image-events/image-errored.md): Magic Hour notifies your server when an image project fails. Use this page for error payload fields, project metadata, and validating signed webhook requests from Magic Hour.
- [Image Started](https://docs.magichour.ai/webhook-reference/image-events/image-started.md): Magic Hour notifies your server when an image project begins processing. Document signature headers, JSON schema, and example payload for image-generation webhooks.
- [Video Completed](https://docs.magichour.ai/webhook-reference/video-events/video-completed.md): Magic Hour notifies your server when a video project finishes successfully. Payload includes download URLs, dimensions, credits charged, and fields to verify with the Get Video Details API.
- [Video Errored](https://docs.magichour.ai/webhook-reference/video-events/video-errored.md): Magic Hour notifies your server when a video project fails. Webhook reference for error code, message, project id, and HMAC-signed headers your endpoint should validate.
- [Video Started](https://docs.magichour.ai/webhook-reference/video-events/video-started.md): Magic Hour notifies your server when a video project begins processing. Reference signed headers, JSON payload fields, and example body for your webhook handler.

## OpenAPI Specs

- [openapi](https://docs.magichour.ai/api-reference/openapi.json)

## Optional

- [Community](https://discord.com/invite/JX5rgsZaJp)
- [Status](https://status.magichour.ai)