API Documentation and Integration Guide

# Python pip install magic_hour  # Node.js npm install magic-hour  # Go go get -u github.com/magichourhq/magic-hour-go  # Rust cargo add magic_hour

curl -X POST https://api.magichour.ai/v1/ai-image-generator \   -H "Authorization: Bearer YOUR_API_KEY" \   -H "Content-Type: application/json" \   -d '{"style": {"prompt": "your prompt"}}'

from magic_hour import Client  client = Client(token="YOUR_API_KEY")  result = client.v1.ai_image_generator.generate(     image_count=1,     orientation="landscape",     style={"prompt": "Epic anime art of a wizard"},     wait_for_completion=True,     download_outputs=True,     download_directory="outputs" )  print(f"Image created: {result.id}") print(f"Credits spent: {result.credits_charged}") print(f"Saved to: {result.downloaded_paths}")

from magic_hour import Client import time  client = Client(token="YOUR_API_KEY")  # Create the job job = client.v1.face_swap.generate(     name="My face swap",     assets={         "image_file_path": "https://example.com/face.jpg",         "video_file_path": "https://example.com/video.mp4",         "video_source": "file"     },     start_seconds=0.0,     end_seconds=10.0 )  print(f"Job ID: {job.id}")

{   "assets": {     "image_file_path": "https://cdn.yoursite.com/face.jpg",     "video_file_path": "https://cdn.yoursite.com/video.mp4"   } }

import time from magic_hour import Client  client = Client(token="YOUR_API_KEY")  # Create job job = client.v1.ai_image_generator.create(     image_count=1,     style={"prompt": "Epic wizard"} )  # Poll for completion while True:     status = client.v1.image_projects.get(id=job.id)      if status.status == "complete":         print(f"✅ Done! Downloads: {status.downloads}")         break     elif status.status == "error":         print(f"❌ Error: {status.error}")         break     else:         print(f"Status: {status.status}")         time.sleep(3)

{   "status": "complete",   "downloads": [     {       "url": "https://video.magichour.ai/id/output.mp4?auth-token=abc123",       "expires_at": "2024-10-19T05:16:19.027Z"     }   ] }

import requests from pathlib import Path  def download_result(download_url, output_path="result.mp4"):     response = requests.get(download_url, stream=True, timeout=60)     response.raise_for_status()      with open(output_path, "wb") as f:         for chunk in response.iter_content(chunk_size=8192):             if chunk:                 f.write(chunk)      file_size = Path(output_path).stat().st_size     print(f"✅ Downloaded: {output_path} ({file_size} bytes)")  # Usage download_result("https://video.magichour.ai/id/output.mp4?auth-token=abc123")

{   "status": "error",   "error": {     "code": "no_source_face",     "message": "Please use an image with a detectable face"   } }

import time from magic_hour import Client  client = Client(token="YOUR_API_KEY")  try:     job = client.v1.face_swap.generate(         assets={             "image_file_path": "https://example.com/face.jpg",             "video_file_path": "https://example.com/video.mp4"         }     )      while True:         status = client.v1.video_projects.get(id=job.id)          if status.status == "complete":             print("✅ Job complete")             break         elif status.status == "error":             error_code = status.error.get("code", "unknown")             error_msg = status.error.get("message", "Unknown error")              if error_code == "no_source_face":                 print("❌ No face detected. Use a different image.")             else:                 print(f"❌ Error ({error_code}): {error_msg}")             break          time.sleep(5)  except Exception as e:     print(f"❌ Request failed: {e}")

from magic_hour import Client from magic_hour.environment import Environment  # Development/testing (no credits charged) client = Client(     token="YOUR_API_KEY",     environment=Environment.MOCK_SERVER )  # All calls return realistic mock data result = client.v1.face_swap.generate(...)

from magic_hour import Client  client = Client(token="YOUR_API_KEY")  # Delete a video project client.v1.video_projects.delete(id="project_id")  # Delete an image project client.v1.image_projects.delete(id="project_id")

from magic_hour import Client  client = Client(token="YOUR_API_KEY")  face_url = "https://example.com/face.jpg" video_urls = [     "https://example.com/video1.mp4",     "https://example.com/video2.mp4",     "https://example.com/video3.mp4" ]  jobs = [] for video_url in video_urls:     job = client.v1.face_swap.generate(         assets={             "image_file_path": face_url,             "video_file_path": video_url         }     )     jobs.append(job)     print(f"Started batch job: {job.id}")