Lip Sync Tool - Magic Hour Docs

from magic_hour import Client
import os

client = Client(token=os.getenv("MAGIC_HOUR_API_KEY"))

result = client.v1.lip_sync.generate(
    assets={
        "audio_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/you-are-just-a-line-of-code.mp3",
        "video_file_path": "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/sideeyegirl.mp4",
        "video_source": "file"
    },
    end_seconds=2,
    start_seconds=0,
    max_fps_limit=30,
    style={
        "generation_mode": "lite"
    },
    name="Side Eye Girl Code Lip Sync",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Lip sync complete!")
    print(f"Downloaded to: {result.downloaded_paths}")
    print(f"Credits charged: {result.credits_charged}")
else:
    print(f"❌ Job failed with status: {result.status}")
    if hasattr(result, 'error_message'):
        print(f"Error: {result.error_message}")

import { Client } from "magic-hour";

const client = new Client({ token: process.env.MAGIC_HOUR_API_KEY });

const result = await client.v1.lipSync.generate({
  assets: {
    audioFilePath:
      "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/you-are-just-a-line-of-code.mp3",
    videoFilePath:
      "https://raw.githubusercontent.com/runshouse/Sample_Assets/main/obamamicdrop.mov",
    videoSource: "file",
  },
  endSeconds: 2,
  startSeconds: 0,
  maxFpsLimit: 8,
  style: {
    generationMode: "lite",
  },
  name: "Obama Code Lip Sync",
  waitForCompletion: true,
  downloadOutputs: true,
  downloadDirectory: ".",
});

console.log(`✅ Lip sync complete!`);
console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);