API Reference

Magic Hour APIs create and manage video, image, and audio projects. Most creation endpoints return a project ID immediately; use the matching details endpoint or a webhook to track completion.

​

Files

• POST /v1/files/generate-upload-urls — Generate asset upload URLs
• GET /v1/files/:id/face-detection — Get face detection details
• POST /v1/files/face-detection — Detect faces in an asset

​

Video projects

​

Manage projects

• GET /v1/video-projects/:id — Get video details
• DELETE /v1/video-projects/:id — Delete a video

​

Create projects

• POST /v1/ai-talking-photo — AI Talking Photo
• POST /v1/ai-video-editor — AI Video Editor
• POST /v1/animation — Animation
• POST /v1/audio-to-video — Audio to Video
• POST /v1/auto-subtitle-generator — Auto Subtitle Generator
• POST /v1/character-replace — Character Replace
• POST /v1/face-swap — Face Swap Video
• POST /v1/image-to-video — Image to Video
• POST /v1/lip-sync — Lip Sync
• POST /v1/text-to-video — Text to Video
• POST /v1/video-to-video — Video to Video

​

Image projects

​

Manage projects

• GET /v1/image-projects/:id — Get image details
• DELETE /v1/image-projects/:id — Delete an image

​

Create projects

• POST /v1/ai-clothes-changer — AI Clothes Changer
• POST /v1/ai-face-editor — AI Face Editor
• POST /v1/ai-gif-generator — AI GIF Generator
• POST /v1/ai-headshot-generator — AI Headshot Generator
• POST /v1/ai-image-editor — AI Image Editor
• POST /v1/ai-image-generator — AI Image Generator
• POST /v1/ai-image-upscaler — AI Image Upscaler
• POST /v1/ai-meme-generator — AI Meme Generator
• POST /v1/ai-qr-code-generator — AI QR Code Generator
• POST /v1/body-swap — Body Swap
• POST /v1/face-swap-photo — Face Swap Photo
• POST /v1/head-swap — Head Swap
• POST /v1/image-background-remover — Image Background Remover
• POST /v1/photo-colorizer — Photo Colorizer

​

Audio projects

​

Manage projects

• GET /v1/audio-projects/:id — Get audio details
• DELETE /v1/audio-projects/:id — Delete audio

​

Create projects

• POST /v1/ai-voice-generator — AI Voice Generator
• POST /v1/ai-voice-cloner — AI Voice Cloner