Development and Testing

from magic_hour import Client
from magic_hour.environment import Environment

# Use mock server for development
client = Client(
    token="YOUR_API_KEY",  # Can use any value for mock mode
    environment=Environment.MOCK_SERVER
)

# All API calls return mock data instantly
result = client.v1.ai_image_generator.create(
    image_count=1,
    aspect_ratio="16:9",
    resolution="1k",
    style={"prompt": "Test image", "tool": "ai-anime-generator"}
)

print(f"Job ID: {result.id}")  # Returns mock ID
# No credits charged, no actual processing

import Client, { Environment } from "magic-hour";

// Use mock server for development
const client = new Client({
  token: "YOUR_API_KEY", // Can use any value for mock mode
  environment: Environment.MockServer,
});

// All API calls return mock data instantly
const result = await client.v1.aiImageGenerator.create({
  imageCount: 1,
  aspectRatio: "16:9",
  resolution: "1k",
  style: { prompt: "Test image", tool: "ai-anime-generator" },
});

console.log(`Job ID: ${result.id}`); // Returns mock ID
// No credits charged, no actual processing

import os
from magic_hour import Client
from magic_hour.environment import Environment

# Switch environments based on ENV variable
env = Environment.MOCK_SERVER if os.getenv("ENV") == "development" else Environment.PRODUCTION

client = Client(
    token=os.getenv("MAGIC_HOUR_API_KEY"),
    environment=env
)

import Client, { Environment } from "magic-hour";

// Switch environments based on NODE_ENV
const environment =
  process.env.NODE_ENV === "development" ? Environment.MockServer : Environment.Production;

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

import httpx
from magic_hour import Client

client = Client(token="YOUR_API_KEY")

try:
    result = client.v1.ai_image_generator.create(
        image_count=1,
        aspect_ratio="16:9",
        resolution="1k",
        style={"prompt": "Test"},
    )

except httpx.HTTPStatusError as e:
    code = e.response.status_code
    detail = e.response.text[:300]

    if code == 401:
        print("❌ Invalid API key. Check your credentials.")
    elif code == 403:
        print("❌ Forbidden. Key lacks permission or resource is protected.")
    elif code == 422:
        print(f"❌ Invalid parameters: {detail}")
    elif code == 429:
        print("❌ Rate limit exceeded. Wait before retrying.")
    else:
        print(f"❌ API error ({code}): {detail}")

except Exception as e:
    print(f"❌ Unexpected error: {e}")

import { Client } from "magic-hour";

const client = new Client({ token: "YOUR_API_KEY" });

try {
  const result = await client.v1.aiImageGenerator.create({
    imageCount: 1,
    aspectRatio: "16:9",
    resolution: "1k",
    style: { prompt: "Test" },
  });
} catch (error) {
  if (error.statusCode === 401) {
    console.log("❌ Invalid API key. Check your credentials.");
  } else if (error.statusCode === 422) {
    console.log(`❌ Invalid parameters: ${error.message}`);
    // Fix your request parameters
  } else if (error.statusCode === 429) {
    console.log("❌ Rate limit exceeded. Wait before retrying.");
    // Implement exponential backoff
  } else {
    console.log(`❌ API error: ${error.message}`);
    // Log error and alert monitoring system
  }
}

import time

download_url = None

job_id = "your_job_id" # Change this to your job ID

while True:
    status = client.v1.image_projects.get(id=job_id)

    if status.status == "complete":
        download_url = status.downloads[0].url
        break

    if status.status == "error":
        err = status.error or {}
        error_code = err.get("code", "unknown")
        error_msg = err.get("message", "Unknown error")

        if error_code == "no_source_face":
            print("❌ No face detected. Use an image with a visible face.")
        elif error_code == "invalid_file_format":
            print("❌ Unsupported file format. Check supported formats.")
        elif error_code == "file_too_large":
            print("❌ File too large. Reduce file size or upgrade tier.")
        elif error_code == "insufficient_credits":
            print("❌ Not enough credits. Add credits to your account.")
        else:
            print(f"❌ Error ({error_code}): {error_msg}")

        break

    time.sleep(3)

if not download_url:
    raise RuntimeError("Job did not complete successfully; no download URL available.")

// Poll for completion with error handling
while (true) {
  const status = await client.v1.imageProjects.get({ id: jobId });

  if (status.status === "complete") {
    // Success - download result
    const downloadUrl = status.downloads[0].url;
    break;
  } else if (status.status === "error") {
    // Job failed during processing
    const errorCode = status.error?.code || "unknown";
    const errorMsg = status.error?.message || "Unknown error";

    // Handle specific error codes
    switch (errorCode) {
      case "no_source_face":
        console.log("❌ No face detected. Use an image with a visible face.");
        break;
      case "invalid_file_format":
        console.log("❌ Unsupported file format. Check supported formats.");
        break;
      case "file_too_large":
        console.log("❌ File too large. Reduce file size or upgrade tier.");
        break;
      case "insufficient_credits":
        console.log("❌ Not enough credits. Add credits to your account.");
        break;
      default:
        console.log(`❌ Error (${errorCode}): ${errorMsg}`);
    }

    return null;
  }

  await new Promise((resolve) => setTimeout(resolve, 3000));
}