AI Image Generator Tool - Magic Hour Docs

Overview

AI Image Generator creates high-quality images from text descriptions using advanced AI models. The API generates original artwork, photos, illustrations, and designs based on detailed text prompts with customizable styles, aspect ratios, and resolutions. Typical processing time: ~5s median (see all processing times)

How It Works

Write a prompt - Describe the image you want to create
Choose a style - Select from 30+ art styles and tools
Set the aspect ratio - Choose 1:1, 16:9, or 9:16
API generates images - AI creates images matching your description
Download results - Retrieve your generated images

Use Cases

Content creation - Generate images for blogs, social media, marketing
Concept art - Visualize ideas before production
Stock photo replacement - Create custom images on-demand
Product mockups - Generate product visualizations
Creative projects - Artwork, illustrations, and designs

Best Practices

Writing Effective Prompts

Be specific and descriptive - The more detail you provide, the better the results.

✅ Good prompts:

“A serene mountain landscape at sunset with vibrant orange and purple colors, dramatic clouds, photorealistic style”
“Minimalist logo design of a flying bird in blue gradient, vector art style, clean lines”
“Cozy coffee shop interior with warm lighting, wooden furniture, plants, cinematic photography”

❌ Avoid:

Too vague: “A nice picture”
Too short: “Mountain”
Conflicting instructions: “Bright dark image”

Style Selection

Magic Hour offers 30+ art styles. Match the style to your use case:

Use Case	Recommended Styles
Marketing photos	Photorealistic, Cinematic
Illustrations	Anime, Cartoon, Watercolor
Logos & icons	Vector, Minimalist
Concept art	Digital Art, Fantasy

Aspect Ratio Guidelines

Set the aspect_ratio parameter to control the output shape:

`aspect_ratio`	Shape	Best For
`1:1`	Square	Profile pictures, thumbnails, social posts
`16:9`	Landscape	Banners, headers, desktop wallpapers
`9:16`	Portrait	Stories, mobile wallpapers, posters

Code Examples

Basic Image Generation

from magic_hour import Client
import os

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

result = client.v1.ai_image_generator.generate(
    image_count=1,
    aspect_ratio="16:9",
    style={
        "prompt": "A serene mountain landscape at sunset with vibrant colors",
        "tool": "ai-photo-generator"
    },
    name="Mountain Sunset",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Image 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.aiImageGenerator.generate({
  imageCount: 1,
  aspectRatio: "16:9",
  style: {
    prompt: "A serene mountain landscape at sunset with vibrant colors",
    tool: "ai-photo-generator",
  },
  name: "Mountain Sunset",
  waitForCompletion: true,
  downloadOutputs: true,
  downloadDirectory: ".",
});

console.log(`✅ Image complete!`);
console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);
console.log(`Credits charged: ${result.creditsCharged}`);

Generate Multiple Images

result = client.v1.ai_image_generator.generate(
    image_count=4,  # Generate 4 variations
    aspect_ratio="1:1",
    style={
        "prompt": "Cute cat wearing sunglasses, digital art style",
        "tool": "ai-anime-generator"
    },
    name="Cat Variations",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Image 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}")

const result = await client.v1.aiImageGenerator.generate({
  imageCount: 4, // Generate 4 variations
  aspectRatio: "1:1",
  style: {
    prompt: "Cute cat wearing sunglasses, digital art style",
    tool: "ai-anime-generator",
  },
  name: "Cat Variations",
  waitForCompletion: true,
  downloadOutputs: true,
  downloadDirectory: ".",
});

console.log(`✅ Image complete!`);
console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);
console.log(`Credits charged: ${result.creditsCharged}`);

Portrait Orientation

result = client.v1.ai_image_generator.generate(
    image_count=1,
    aspect_ratio="9:16",
    style={
        "prompt": "Professional business woman in modern office",
        "tool": "ai-photo-generator"
    },
    name="Business Portrait",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Images 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}")

const result = await client.v1.aiImageGenerator.generate({
  imageCount: 1,
  aspectRatio: "9:16",
  style: {
    prompt: "Professional business woman in modern office",
    tool: "ai-photo-generator",
  },
  name: "Business Portrait",
  waitForCompletion: true,
  downloadOutputs: true,
  downloadDirectory: ".",
});

console.log(`✅ Image complete!`);
console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);
console.log(`Credits charged: ${result.creditsCharged}`);

Pricing

Cost depends on the model you choose (the default model is picked automatically and may change over time):

Model	Credits per image (from)	Tiers
`flux-schnell`	5	All (including free)
`flux-2-klein`	5	All (including free)
`z-image-turbo`	5	All (including free)
`seedream-v4`	40	Creator, Pro, Business
`gpt-image-2`	50	Creator, Pro, Business
`nano-banana`	50	Creator, Pro, Business
`nano-banana-2-lite`	50	Creator, Pro, Business
`seedream-v5-pro`	75	Creator, Pro, Business
`nano-banana-2`	100	Creator, Pro, Business
`nano-banana-pro`	150	Creator, Pro, Business

Higher resolutions can increase the cost — see the model parameter in the API reference for supported resolutions and image counts per model.

Try this in our Google Colab Cookbook: Run this API with sample code. Just add your API key.

API Reference

AI Image Generator API Reference

View full API specification

AI Image Upscaler

Enhance image resolution

Image Background Remover

Remove image backgrounds

Get Started

Integration

Billing

Tools

AI Image Generator Tool - Magic Hour Docs

Overview

How It Works

Use Cases

Best Practices

Writing Effective Prompts

Style Selection

Aspect Ratio Guidelines

Code Examples

Basic Image Generation

Generate Multiple Images

Portrait Orientation

Pricing

API Reference

AI Image Generator API Reference

AI Image Upscaler

Image Background Remover

​Overview

​How It Works

​Use Cases

​Best Practices

​Writing Effective Prompts

​Style Selection

​Aspect Ratio Guidelines

​Code Examples

​Basic Image Generation

​Generate Multiple Images

​Portrait Orientation

​Pricing

​API Reference

AI Image Generator API Reference

​Related Tools

AI Image Upscaler

Image Background Remover

Overview

How It Works

Use Cases

Best Practices

Writing Effective Prompts

Style Selection

Aspect Ratio Guidelines

Code Examples

Basic Image Generation

Generate Multiple Images

Portrait Orientation

Pricing

API Reference

Related Tools