- Category: ai content generation
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 38
- Triggers: 0
- Slug:
MAGIC_HOUR - Version: 00000000_00
Tools
Create AI Clothes Change
Create AI Clothes Change
MAGIC_HOUR_CREATE_AI_CLOTHES_CHANGEStart 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 immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error.Input Parameters
Output
Create AI Face Edit
Create AI Face Edit
MAGIC_HOUR_CREATE_AI_FACE_EDITStart 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 status is complete or error.Input Parameters
Output
Create AI GIF
Create AI GIF
MAGIC_HOUR_CREATE_AI_GIFStart 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 until status is complete, error, or canceled.Input Parameters
Output
Create AI Headshot
Create AI Headshot
MAGIC_HOUR_CREATE_AI_HEADSHOTStart 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 until status is complete, error, or canceled.Input Parameters
Output
Create AI Image
Create AI Image
MAGIC_HOUR_CREATE_AI_IMAGEStart 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-schnell, and z-image-turbo are documented for Free. Pass the returned ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error.Input Parameters
Output
Create AI Image Edit
Create AI Image Edit
MAGIC_HOUR_CREATE_AI_IMAGE_EDITStart 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 MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error.Input Parameters
Output
Create AI Meme
Create AI Meme
MAGIC_HOUR_CREATE_AI_MEMEStart 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_PROJECT and poll until status is complete or error.Input Parameters
Output
Create AI QR Code
Create AI QR Code
MAGIC_HOUR_CREATE_AI_QR_CODEStart 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_HOUR_GET_IMAGE_PROJECT until status is complete or error.Input Parameters
Output
Create AI Video Edit
Create AI Video Edit
MAGIC_HOUR_CREATE_AI_VIDEO_EDITStart 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 initially an estimate. Pass the returned project ID to MAGIC_HOUR_GET_VIDEO_PROJECT and poll until status is complete, error, or canceled.Input Parameters
Output
Create AI Voice
Create AI Voice
MAGIC_HOUR_CREATE_AI_VOICEStart 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 audio; pass the ID to MAGIC_HOUR_GET_AUDIO_PROJECT and poll until status is complete or error.Input Parameters
Output
Create AI Voice Clone
Create AI Voice Clone
MAGIC_HOUR_CREATE_AI_VOICE_CLONEStart 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 immediate credit charge, not completed audio; pass the ID to MAGIC_HOUR_GET_AUDIO_PROJECT and poll until status is complete or error.Input Parameters
Output
Create Animation Video
Create Animation Video
MAGIC_HOUR_CREATE_ANIMATION_VIDEOStart 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_VIDEO_PROJECT and poll until complete, error, or canceled.Input Parameters
Output
Create Audio-to-Video
Create Audio-to-Video
MAGIC_HOUR_CREATE_AUDIO_TO_VIDEOStart 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 ID immediately; poll MAGIC_HOUR_GET_VIDEO_PROJECT until the project is complete, error, or canceled. Requires sufficient credits, and the initial credits_charged value is an estimate until rendering finishes.Input Parameters
Output
Create Background Removal
Create Background Removal
MAGIC_HOUR_CREATE_BACKGROUND_REMOVALStart 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 an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error.Input Parameters
Output
Create Body Swap
Create Body Swap
MAGIC_HOUR_CREATE_BODY_SWAPStart 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; pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. Credits are charged when this request is made and refunded if generation fails.Input Parameters
Output
Create Character Animation Video
Create Character Animation Video
MAGIC_HOUR_CREATE_CHARACTER_ANIMATION_VIDEOAnimate 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 estimated credit charge, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled.Input Parameters
Output
Create Character Replacement Video
Create Character Replacement Video
MAGIC_HOUR_CREATE_CHARACTER_REPLACEMENT_VIDEOReplace 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 credit charge, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled.Input Parameters
Output
Create Face Swap Photo
Create Face Swap Photo
MAGIC_HOUR_CREATE_FACE_SWAP_PHOTOStart 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, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error.Input Parameters
Output
Create Face Swap Video
Create Face Swap Video
MAGIC_HOUR_CREATE_FACE_SWAP_VIDEOStart 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 and estimated charge immediately, not a completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled.Input Parameters
Output
Create Head Swap
Create Head Swap
MAGIC_HOUR_CREATE_HEAD_SWAPStart 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 until status is complete or error. Credits are charged when this request is made and refunded if generation fails.Input Parameters
Output
Create Image-to-Video
Create Image-to-Video
MAGIC_HOUR_CREATE_IMAGE_TO_VIDEOStart 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 the connected account’s plan. Returns a project ID and estimated credit charge immediately; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled.Input Parameters
Output
Create Image Upscale
Create Image Upscale
MAGIC_HOUR_CREATE_IMAGE_UPSCALEStart 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_GET_IMAGE_PROJECT until status is complete or error.Input Parameters
Output
Create Lip Sync Video
Create Lip Sync Video
MAGIC_HOUR_CREATE_LIP_SYNC_VIDEOStart 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 returned credit charge is an estimate, may be adjusted after rendering based on actual output FPS, and is refunded if generation fails.Input Parameters
Output
Create Photo Colorization
Create Photo Colorization
Create Subtitled Video
Create Subtitled Video
MAGIC_HOUR_CREATE_SUBTITLED_VIDEOStart 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 canceled. The initial credit charge is an estimate, can be adjusted after rendering, and is refunded if generation fails.Input Parameters
Output
Create Talking Photo
Create Talking Photo
MAGIC_HOUR_CREATE_TALKING_PHOTOStart 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 returns immediately with a video project ID; pass that ID to MAGIC_HOUR_GET_VIDEO_PROJECT and poll until complete, error, or canceled.Input Parameters
Output
Create Text-to-Video
Create Text-to-Video
MAGIC_HOUR_CREATE_TEXT_TO_VIDEOStart 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 project ID and estimated credit charge, not a completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled.Input Parameters
Output
Create Video-to-Video
Create Video-to-Video
MAGIC_HOUR_CREATE_VIDEO_TO_VIDEOStart 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 estimated credit charge immediately, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled.Input Parameters
Output
Delete Audio Project
Delete Audio Project
MAGIC_HOUR_DELETE_AUDIO_PROJECTPermanently 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.Input Parameters
Output
Delete Image Project
Delete Image Project
MAGIC_HOUR_DELETE_IMAGE_PROJECTPermanently 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.Input Parameters
Output
Delete Video Project
Delete Video Project
MAGIC_HOUR_DELETE_VIDEO_PROJECTPermanently 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.Input Parameters
Output
Detect Faces
Detect Faces
MAGIC_HOUR_DETECT_FACESStart 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 may change.Input Parameters
Output
Generate Asset Upload URLs
Generate Asset Upload URLs
MAGIC_HOUR_GENERATE_ASSET_UPLOAD_URLSGenerate 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.Input Parameters
Output
Get Account
Get Account
Get Audio Project
Get Audio Project
Get Face Detection
Get Face Detection
MAGIC_HOUR_GET_FACE_DETECTIONGet 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 successful response does not prove the task exists.Input Parameters
Output
Get Image Project
Get Image Project