Body Swap Tool - Magic Hour Docs

​

Overview

​

How It Works

1. Upload a scene image - Choose the image whose existing person will be replaced
2. Upload a person image - Provide the person you want to place into the scene
3. Choose a resolution - Select 640px, 1k, 2k, or 4k
4. Create the job - Submit both file paths to the API
5. Download the result - Poll until complete and retrieve the generated image

​

Use Cases

• Campaign concepts - Test different people in finished layouts before a shoot
• Character concepts - Place a subject into fantasy, editorial, or themed scenes
• Content variants - Generate multiple versions of one composition
• Social content - Create personalized scene and meme edits
• Previsualization - Compare talent, wardrobe, or creative direction quickly

​

Best Practices

• Choose an unobstructed scene subject - Avoid heavy overlap from hands, objects, or other people
• Match pose and camera angle - Similar framing helps the replacement fit naturally
• Use high-quality inputs - Compression, blur, and tiny subjects reduce output detail
• Match lighting - Similar light direction and intensity improve scene integration
• Test at lower resolution - Confirm the composition before requesting a larger output

​

Code Example

curl --request POST \
  --url https://api.magichour.ai/v1/body-swap \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token>' \
  --header 'content-type: application/json' \
  --data '
{
  "name": "My Body Swap image",
  "resolution": "1k",
  "assets": {
    "person_file_path": "api-assets/id/1234.png",
    "scene_file_path": "api-assets/id/5678.png"
  }
}
'

​

Pricing

​

API Reference

​

Related Tools