Magic Hour
Magic Hour is an AI media creation platform for generating and editing images, videos, and audio through a unified API.
Verdict
Common use cases
- Generate hero images for blog posts
- Swap product photos into lifestyle scenes
- Create branded memes from templates
- Turn sketches into polished mockups
- Produce headshots for team directory
Integration
- Vendor
- Magic Hour
- Category
- other
- Auth
- API_KEY
- Tools
- 38
- Composio slug
magic_hour
Tools
- Create AI Clothes Change
Start a credit-consuming asynchronous clothes-change image job from person and garment images. Each image costs 25 credits. The operation is documented for Free accounts but requires sufficient credits. It returns an image project ID immedi
- Create AI Face Edit
Start a credit-consuming asynchronous edit of facial features in an image. This Free-tier operation returns an image project ID and credit charge immediately, not a completed image. Pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until
- Create AI GIF
Start a credit-consuming asynchronous prompt-based animation in GIF, MP4, or WebM format. This operation costs 50 credits and returns an image project ID immediately, not completed media. Pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll
- Create AI Headshot
Start a credit-consuming asynchronous headshot generation from an image containing one detectable face. Each headshot costs 50 credits. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT u
- Create AI Image
Start a credit-consuming asynchronous text-to-image job. The request returns a project ID and immediate credit charge, not completed images. Model, image-count, resolution, cost, and tier availability vary by option; only flux-2-klein, flux
- Create AI Image Edit
Start a credit-consuming asynchronous prompt-based edit of one or more images. Model, resolution, input-image limits, cost, and tier availability vary by option. Credits are charged when the request is made. Pass the returned project ID to
- Create AI Meme
Start a credit-consuming asynchronous meme generation from a topic and a documented Magic Hour template. Each meme costs 10 credits. This returns an image project ID immediately, not a completed image; pass the ID to MAGIC_HOUR_GET_IMAGE_PR
- Create AI QR Code
Start an asynchronous artistic QR-code generation for supplied content. Magic Hour documents each AI QR code as costing 0 credits. The operation returns an image project ID and credits charged immediately, not a completed image; poll MAGIC_
- Create AI Video Edit
Start a credit-consuming asynchronous prompt-based edit of an input video. Free accounts default to the ltx-2.3 model and 480p; other model and resolution options depend on the connected account's plan. The returned credit charge is initial
- Create AI Voice
Start credit-consuming asynchronous speech generation from text using a documented preset voice. Each character costs 0.1 credits, rounded up to a whole credit. This returns an audio project ID and immediate credit charge, not completed aud
- Create AI Voice Clone
Start credit-consuming asynchronous speech generation by cloning an input voice recording. Each prompt character costs 0.1 credits, rounded up to a whole credit, and sufficient credits are required. This returns an audio project ID and imme
- Create Animation Video
Start one credit-consuming asynchronous animation render with explicit dimensions, frame rate, duration, style, and assets. The request returns immediately with a video project ID and estimated credits charged; pass the ID to MAGIC_HOUR_GET
- Create Audio-to-Video
Start a credit-consuming asynchronous video generation job from audio and optional visual style controls. Free accounts can use the documented 480p default; higher resolutions depend on the connected account's plan. Returns a video project
- Create Background Removal
Start a credit-consuming asynchronous image job that removes a background or replaces it with an optional supplied image. Each image costs 5 credits. The operation is documented for Free accounts but requires sufficient credits. It returns
- Create Body Swap
Start a credit-consuming asynchronous body-swap image job that places a person into a scene at the selected resolution. Resolution determines the model and credit cost. This returns an image project ID immediately, not a completed image; pa
- Create Character Animation Video
Animate a reference character with motion transferred from a source video in a credit-consuming asynchronous job. The documented 480p default is available on Free; 720p depends on the connected account's plan. This returns a project ID and
- Create Character Replacement Video
Replace a source-video subject with a reference character in a credit-consuming asynchronous video job. The documented 480p default is available on Free; 720p depends on the connected account's plan. This returns a project ID and estimated
- Create Face Swap Photo
Start a credit-consuming asynchronous photo face swap using one source face for all detected faces or up to five individual face mappings. Each photo costs 10 credits. The operation returns an image project ID and credit charge immediately,
- Create Face Swap Video
Start a credit-consuming asynchronous video face-swap job using one image for all detected faces or up to five individual face mappings. The operation is documented for Free accounts but requires sufficient credits. It returns a project ID
- Create Head Swap
Start a credit-consuming asynchronous head-swap image job from body and head images. Each image costs 10 credits. This returns an image project ID immediately, not a completed image; pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll unti
- Create Image-to-Video
Start a credit-consuming asynchronous video generation job from a still image and optional final frame, prompt, audio, model, and resolution controls. Free accounts default to ltx-2.5 at 480p; other model and resolution options depend on th
- Create Image Upscale
Start a credit-consuming asynchronous 2x or 4x image upscale. A 4x upscale requires a Creator, Pro, or Business tier, while mode affects the credit charge. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR
- Create Lip Sync Video
Start a credit-consuming asynchronous lip-sync video job from audio and a file or YouTube video. This returns a project ID immediately, not the completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until complete, error, or canceled. The retur
- Create Photo Colorization
Start a credit-consuming asynchronous colorization of a photo. Each image costs 10 credits. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error.
- Create Subtitled Video
Start a credit-consuming asynchronous job that transcribes speech and burns styled subtitles into an MP4 video. This returns a project ID immediately, not the completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until complete, error, or canc
- Create Talking Photo
Start a credit-consuming asynchronous talking-photo video from an image and audio. This operation is documented for Free accounts, but requires enough credits and available models and resolutions depend on the connected account's tier. It r
- Create Text-to-Video
Start a credit-consuming asynchronous video generation job from a text prompt and model/output options. Free accounts default to ltx-2.5 at 480p; model, duration, aspect ratio, resolution, and audio availability vary by plan. This returns a
- Create Video-to-Video
Start a credit-consuming asynchronous stylized transformation of an input video. Free accounts can use the documented lower-resolution configuration; higher output quality depends on the connected account's plan. Returns a project ID and es
- Delete Audio Projectdestructive
Permanently delete one rendered Magic Hour audio project by ID. This destructive operation is irreversible and is not a way to cancel a queued or rendering audio project. Success requires exactly HTTP 204 with an empty body.
- Delete Image Projectdestructive
Permanently delete one Magic Hour image project and its rendered images by ID. This destructive operation is irreversible and is not a way to cancel a render. Success requires exactly HTTP 204 with an empty body.
- Delete Video Projectdestructive
Permanently delete one rendered Magic Hour video project by ID. This destructive operation is irreversible and is not a way to cancel a queued or rendering video. Success requires exactly HTTP 204 with an empty body.
- Detect Faces
Start asynchronous face detection for an image or video and return a task ID. Pass the returned ID to MAGIC_HOUR_GET_FACE_DETECTION and poll until status is complete or error. Face detection is currently documented as free, though pricing m
- Generate Asset Upload URLs
Generate ordered, expiring signed upload URLs and Magic Hour file paths for image, video, or audio assets. This allocates upload URLs but does not upload file bytes. Treat each signed URL query string as sensitive: do not log or persist it.
- Get Account
Return the connected Magic Hour account's tier, available credits, identity, and subscription details; use this before generation to check entitlement and balance.
- Get Audio Project
Get an audio project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire at their expires_at timestamps; call this tool again afterward to obtain refreshed URLs
- Get Face Detection
Get face-detection status and detected face paths by task ID. Poll only IDs returned by MAGIC_HOUR_DETECT_FACES and stop on complete or error: live probing showed that arbitrary and malformed IDs can return 200 queued indefinitely, so a suc
- Get Image Project
Get an image project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire at their expires_at timestamps; call this tool again afterward to obtain refreshed URLs
- Get Video Project
Get a video project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire after 24 hours; call this tool again to refresh expired URLs.
Setup
Setup guide
- 11. In Switchy, open Settings → Integrations → Magic Hour and click Connect. 2. You'll be prompted for a Magic Hour API key — generate one by logging into your Magic Hour account, navigating to API Settings, and copying the key labeled 'Production'. 3. Paste the key into Switchy and click Authorize. 4. Switchy will verify the key by listing your current credit balance; if it succeeds, the integration status turns green. 5. Open any Project and type '@Magic Hour create an AI headshot from this image' with an attached photo to test — the MCP will return a project ID and credit charge. 6. Wait 30-90 seconds, then ask '@Magic Hour check status of project [ID]' to retrieve the finished headshot URL. 7. Remember each tool documents its credit cost and tier availability — Free accounts can run most operations but hit rate limits faster than paid tiers.
What teammates see: by default, memories from Magic Hour are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Blog Hero Image
@Magic Hour create an AI image with the prompt 'minimalist office desk with laptop and coffee, soft morning light, top-down view' at 1024x1024 resolution. Use the standard model and return one image.
Outfit Swap for Catalog
@Magic Hour create an AI clothes change using the attached person photo and this garment image. I need the person wearing the new item in a natural pose.
Animated Social Teaser
@Magic Hour create an AI GIF from the prompt 'rocket launching from a laptop keyboard, colorful smoke trail, loop seamlessly' in MP4 format. Keep it under 5 seconds.
Branded QR Code
@Magic Hour create an AI QR code for https://example.com/promo with the style prompt 'geometric patterns in brand colors, high contrast, modern'. Make it scannable on mobile.
Meme from Template
@Magic Hour create an AI meme on the topic 'Monday morning meetings' using the Drake template. Keep the text punchy and relatable for a work audience.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@magichour generate a photorealistic image of a mountain cabin at sunset, 1024×1024, using the flux-1.1-pro model.
Started image generation job (project ID: img_abc123). Charged 20 credits. The flux-1.1-pro model will render one 1024×1024 image; typical completion time is 30–90 seconds. Poll the project status endpoint or check your Magic Hour dashboard to retrieve the final asset once processing finishes.
This example shows the async workflow: the MCP returns a project ID immediately, not the finished image. You must poll separately or wait for a webhook. Credit costs vary by model and resolution—confirm your account balance before batch jobs. Free-tier accounts have lower rate limits.
@magichour create an AI headshot from the uploaded profile photo, using the default style preset.
Headshot generation started (project ID: img_def456). Charged 50 credits. Magic Hour detected one face in the input image and will produce a professional headshot render. Check the project status in 60–120 seconds to download the result. If no face is detected, the job will fail and credits are still consumed.
Headshots cost 50 credits per run and require a clear, single-face input. This example highlights the credit-on-request model: you pay when the job starts, not when it completes. Failed jobs (bad input, no face) still deduct credits, so validate images before submission.
@magichour list all my recent image projects from the past week and summarize which ones succeeded versus failed, including total credits spent.
Retrieved 14 image projects created between Dec 15–22. Nine completed successfully (total: 340 credits), three failed due to invalid input (75 credits consumed), two are still processing. The highest spend was a flux-1.1-pro batch (5 images, 100 credits). Failed jobs included one headshot with no detectable face and two image edits with unsupported formats.
This synthesis example pairs the MCP's project-list tool with the AI's reasoning to surface spending patterns and failure modes. Magic Hour charges credits on job start, so tracking failed runs is critical for budget control. The MCP does not refund credits for failures.
Use-case deep-dives
When Magic Hour beats hiring a product photographer
A 6-person Shopify store team needs 40 product variants photographed every week—same hoodie in eight colors, same sneaker on four models. Magic Hour's clothes-change and headshot tools let them shoot one base image per SKU and generate the rest at 25 credits each. The break-even is around 15 variants per month; below that, stock photography is cheaper. Above that, the MCP pays for itself in week two. The 38-tool surface is overkill for this workflow—you'll use three tools max—but the API-key auth means any team member can queue jobs without waiting on design. If your catalog turns over faster than quarterly, and you're currently paying per-shot freelance rates, this is the call.
Magic Hour for high-volume meme and GIF campaigns
A two-person growth team at a DTC brand runs weekly Twitter campaigns that need 20-30 memes and reaction GIFs per drop. Magic Hour's meme tool (10 credits) and GIF tool (50 credits) let them batch-generate assets from a prompt list in under an hour. The documented templates keep output on-brand without a design review loop. This works when speed matters more than pixel-perfect control—if you're A/B testing ten concepts to find one winner, the credit cost is noise. It stops working when you need frame-by-frame art direction or your brand guidelines are stricter than the templates allow. The async return means you can't iterate in real time, so plan the batch the night before. For teams shipping daily social content at startup budgets, the MCP is faster than Canva and cheaper than a contractor.
When face-edit and headshot tools handle profile defaults
A 12-person SaaS company wants to auto-generate professional avatars for 5,000 freemium users who never upload a photo. Magic Hour's face-edit and headshot tools can turn a generic placeholder into a semi-personalized image at 50 credits per user. The math works if your LTV justifies $0.50 per avatar and you're already paying for the credit pool. It doesn't work if you need real-time generation at signup—the async job model adds 10-30 seconds of latency, so you'd pre-generate a library and assign on the fly. The 38-tool catalog is a liability here; you'll never touch 35 of them, and the API surface is harder to audit than a purpose-built avatar service. Use this MCP if you're already on Magic Hour for other workflows and want to consolidate vendors. Otherwise, a dedicated headshot API is cleaner.
Frequently asked
What does the Magic Hour MCP do in Switchy?
It lets your team generate AI images, videos, GIFs, headshots, memes, and artistic QR codes directly from chat. You prompt Switchy, the MCP calls Magic Hour's API, and you get back project IDs that resolve to finished media. All 38 tools are asynchronous — you start a job, then poll for results. It's useful for marketing teams who need quick visual assets without leaving the workspace.
Do I need a Magic Hour account to use this MCP?
Yes. You need an API key from Magic Hour, which means you need an active account with credits. The MCP charges your Magic Hour balance for each job — headshots cost 50 credits, GIFs cost 50, memes cost 10, clothes-change costs 25. Free-tier accounts can use most tools, but you'll hit credit limits quickly. One person on your team should own the API key and manage the credit budget.
Can the MCP edit existing images or only generate new ones?
Both. You can start new text-to-image jobs or edit uploaded images with prompts. The face-edit and image-edit tools let you modify existing files, and the clothes-change tool swaps garments between two images. All edits are asynchronous and cost credits. The MCP doesn't support real-time preview or iterative refinement — each edit is a separate paid job that returns a project ID.
How is this different from using Magic Hour's web app?
The MCP brings generation into your team's chat flow, so you don't context-switch to a browser. You lose the web UI's preview gallery and fine-tuning sliders, but you gain speed and the ability to chain image jobs with other Switchy tools. If your team already lives in chat and needs quick assets, the MCP is faster. If you need precise control, use the web app.
Who should connect the Magic Hour MCP to Switchy?
Whoever manages your Magic Hour subscription and credit budget. That person's API key will be charged for every job the team runs. If multiple people need to generate images, share one connection — the MCP doesn't isolate usage by Switchy user. Set internal guidelines on which tools cost how many credits, or you'll burn through your balance in a day of meme experiments.