Audio to Video Tool - Magic Hour Docs

​

Overview

​

How It Works

1. Upload audio - Use the file upload API and copy its file_path
2. Add optional guidance - Provide a reference image and a prompt describing the scene
3. Choose the segment - Set start time, end time, and output resolution
4. Create the job - Submit the request and poll until its status is complete
5. Download the result - Retrieve the generated video from downloads

​

Use Cases

• Music visuals - Generate shareable visuals for songs and audio clips
• Podcast promotion - Turn excerpts into video content
• Narrated stories - Pair spoken audio with generated scenes
• Social media - Convert audio-first content into video posts
• Creative visualization - Explore visual interpretations of sound and speech

​

Best Practices

• Use clean audio - Clear source audio without clipping or excessive noise produces a stronger input
• Match the image to the prompt - When using a reference image, avoid instructions that conflict with it
• Start with a short segment - Test the visual direction before generating a longer clip
• Choose the needed resolution - Higher resolution takes more processing and may use more credits
• Check segment bounds - end_seconds must be greater than start_seconds

​

Code Example

curl --request POST \
  --url https://api.magichour.ai/v1/audio-to-video \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token>' \
  --header 'content-type: application/json' \
  --data '
{
  "name": "My Audio To Video video",
  "start_seconds": 0,
  "end_seconds": 15,
  "resolution": "720p",
  "assets": {
    "audio_file_path": "api-assets/id/1234.mp3",
    "image_file_path": "api-assets/id/1234.png"
  },
  "style": {
    "prompt": "Car driving through a city"
  }
}
'

​

Pricing

​

API Reference

​

Related Tools