AI Meme Generator API

Overview

AI Meme Generator writes panel text for your chosen meme template and topic.

How It Works

Choose a template - Select from popular meme formats (Drake Hotline Bling, Two Buttons, etc.)
Provide a topic - Describe what the meme should be about
Optional web search - Enable AI to search for relevant context
API generates text - AI creates appropriate text for the meme panels
Download - Retrieve your completed meme

Use Cases

Social media content - Quick meme generation for engagement
Marketing campaigns - Relatable brand content
Internal communications - Team humor and culture building
Educational content - Making learning more engaging
Community management - Timely responses to trends

Best Practices

Topic Selection

Be specific about your topic - Clear topics generate more relevant and funny memes.

✅ Good topics:

“When the code finally works after 3 hours of debugging”
“Designers vs developers arguing about button placement”
“Coffee before and after the first sip”
“Me explaining my job to my parents”

❌ Avoid:

Vague topics like “work” or “life”
Topics requiring extensive context
Offensive or controversial subjects

Template Selection

Popular templates work best with their intended formats:

Template	Best For	Example Topic
Drake Hotline Bling	Preferences, choices	”Old code vs new refactored code”
Gru’s Plan	Plans that backfire	”Rewriting it in Rust to save time”
Two Buttons	Difficult decisions	”Fix bug or add feature”
Galaxy Brain	Progressive ideas	”Levels of code optimization”

template accepts Random or a supported template name, including Distracted Boyfriend, This Is Fine, and Surprised Pikachu. See the API reference for the complete template enum. Keep topic between 1 and 200 characters.

Web Search Option

Use search_web in the Python SDK and searchWeb in Node.js or raw JSON.

Enable web search when your topic references current events or trends.
Leave web search disabled, the default, for topics that don’t need current context.
Web search may add slight processing time but improves relevance

Code Examples

Basic Meme Generation

from magic_hour import Client
import os

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

result = client.v1.ai_meme_generator.generate(
    style={
        "search_web": False,
        "template": "Drake Hotline Bling",
        "topic": "When the code finally works after hours of debugging"
    },
    name="Code Works Meme",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Meme 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 result.error:
        print(f"Error: {result.error.code}: {result.error.message}")

import { Client } from "magic-hour";

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

const result = await client.v1.aiMemeGenerator.generate(
  {
    style: {
      searchWeb: false,
      template: "Drake Hotline Bling",
      topic: "When the code finally works after hours of debugging",
    },
    name: "Code Works Meme",
  },
  {
    waitForCompletion: true,
    downloadOutputs: true,
    downloadDirectory: ".",
  }
);

console.log(`Status: ${result.status}`);
console.log(`Downloaded to: ${result.downloadedPaths}`);

Random Template

result = client.v1.ai_meme_generator.generate(
    style={
        "search_web": False,
        "template": "Random",
        "topic": "Forgetting to turn the stove off at 2am"
    },
    name="Stove Meme",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Meme 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 result.error:
        print(f"Error: {result.error.code}: {result.error.message}")

const result = await client.v1.aiMemeGenerator.generate(
  {
    style: {
      searchWeb: false,
      template: "Random",
      topic: "Developers and shiny new frameworks",
    },
    name: "Framework Meme",
  },
  {
    waitForCompletion: true,
    downloadOutputs: true,
    downloadDirectory: ".",
  }
);

console.log(`✅ Downloaded to: ${result.downloadedPaths}`);

With Web Search

result = client.v1.ai_meme_generator.generate(
    style={
        "search_web": True,
        "template": "Two Buttons",
        "topic": "The latest controversy in AI image generation"
    },
    name="AI Controversy Meme",
    wait_for_completion=True,
    download_outputs=True,
    download_directory="."
)

if result.status == "complete":
    print(f"✅ Meme 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 result.error:
        print(f"Error: {result.error.code}: {result.error.message}")

const result = await client.v1.aiMemeGenerator.generate(
  {
    style: {
      searchWeb: true,
      template: "Two Buttons",
      topic: "Latest tech trends in AI development",
    },
    name: "AI Trends Meme",
  },
  {
    waitForCompletion: true,
    downloadOutputs: true,
    downloadDirectory: ".",
  }
);

console.log(`✅ Downloaded to: ${result.downloadedPaths}`);

Pricing

Output	Credits
1 meme	10 credits

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

API Reference