Meme API Documentation

Authorization: Bearer xp_your_api_key_here

https://www.memelair.com/api/v1

curl -X POST https://www.memelair.com/api/v1/memes/generate \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "When you deploy on a Friday"}'

{
  "image_base64": "iVBORw0KGgoAAAANS...",
  "url": "data:image/png;base64,...",
  "content_type": "image/png",
  "template_id": "fine",
  "template_name": "This Is Fine",
  "texts": ["The servers are on fire", "This is fine"]
}

curl -X POST https://www.memelair.com/api/v1/memes/generate-and-post \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "When the intern pushes to main"}'

{
  "success": true,
  "tweet_id": "1895123456789012345",
  "tweet_url": "https://x.com/i/status/1895123456789012345",
  "template_id": "fine",
  "template_name": "This Is Fine",
  "meme_texts": ["The production database", "This is fine"]
}

GET https://www.memelair.com/api/v1/openapi.json

curl https://www.memelair.com/api/v1/memes \
  -H "Authorization: Bearer xp_your_key"

{
  "memes": [
    {
      "id": "drake",
      "name": "Drake Hotline Bling",
      "box_count": 2,
      "preview_url": "https://www.memelair.com/api/v1/memes/drake/image"
    },
    {
      "id": "distracted",
      "name": "Distracted Boyfriend",
      "box_count": 3,
      "preview_url": "https://www.memelair.com/api/v1/memes/distracted/image"
    }
  ],
  "total": 210
}

# Full size
curl https://www.memelair.com/api/v1/memes/drake/image \
  -H "Authorization: Bearer xp_your_key" -o drake.png

# Thumbnail
curl "https://www.memelair.com/api/v1/memes/drake/image?thumb=1" \
  -H "Authorization: Bearer xp_your_key" -o drake-thumb.jpg

curl -X POST https://www.memelair.com/api/v1/memes/caption \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "drake",
    "texts": ["Running a meme server", "One API call to Meme Lair"]
  }'

{
  "url": "data:image/png;base64,...",
  "image_base64": "iVBORw0KGgo...",
  "content_type": "image/png"
}

curl -X POST https://www.memelair.com/api/v1/memes/auto \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Just mass-deployed to prod on a Friday"}'

{
  "template_id": "fine",
  "template_name": "This Is Fine",
  "texts": ["The servers are on fire", "This is fine"]
}

curl -X POST https://www.memelair.com/api/v1/post \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "When the code works on first try 😂",
    "image": "data:image/png;base64,iVBORw0KGgo..."
  }'

{
  "success": true,
  "tweet_id": "1895123456789",
  "tweet_url": "https://x.com/i/status/1895123456789"
}

# Step 1: AI picks template + writes text
RESULT=$(curl -s -X POST https://www.memelair.com/api/v1/memes/auto \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Just shipped a feature nobody asked for"}')

TEMPLATE=$(echo $RESULT | jq -r .template_id)
TEXTS=$(echo $RESULT | jq -c .texts)

# Step 2: Render the meme image
MEME=$(curl -s -X POST https://www.memelair.com/api/v1/memes/caption \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d "{\"template_id\":\"$TEMPLATE\",\"texts\":$TEXTS}")

IMAGE_URL=$(echo $MEME | jq -r .url)

# Step 3: Post to X with the meme
curl -X POST https://www.memelair.com/api/v1/post \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d "{\"text\":\"Just shipped a feature nobody asked for 😂\",\"image\":\"$IMAGE_URL\"}"

# Response: {"success":true,"tweet_id":"...","tweet_url":"https://x.com/i/status/..."}

import requests

API_KEY = "xp_your_key"
BASE = "https://www.memelair.com/api/v1"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_and_post_meme(post_text: str):
    """Generate a meme from text and post it to X — 3 API calls."""
    
    # Step 1: AI picks template + writes captions
    auto = requests.post(
        f"{BASE}/memes/auto",
        headers=HEADERS,
        json={"text": post_text}
    ).json()
    print(f"Template: {auto['template_name']}")
    print(f"Captions: {auto['texts']}")
    
    # Step 2: Render the meme image
    meme = requests.post(
        f"{BASE}/memes/caption",
        headers=HEADERS,
        json={
            "template_id": auto["template_id"],
            "texts": auto["texts"]
        }
    ).json()
    
    # Step 3: Post to X with the meme image
    result = requests.post(
        f"{BASE}/post",
        headers=HEADERS,
        json={
            "text": post_text,
            "image": meme["url"]   # pass the data URL directly
        }
    ).json()
    
    print(f"Posted! {result['tweet_url']}")
    return result

# One function call does everything:
generate_and_post_meme("When the code works on first try 😂")

from langchain.tools import tool

@tool
def post_meme(text: str) -> str:
    """Generate an AI meme and post it to X with the given text."""
    import requests
    
    KEY = "xp_your_key"
    BASE = "https://www.memelair.com/api/v1"
    H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}
    
    auto = requests.post(f"{BASE}/memes/auto", headers=H, json={"text": text}).json()
    meme = requests.post(f"{BASE}/memes/caption", headers=H, json={
        "template_id": auto["template_id"], "texts": auto["texts"]
    }).json()
    result = requests.post(f"{BASE}/post", headers=H, json={
        "text": text, "image": meme["url"]
    }).json()
    
    return f"Posted: {result.get('tweet_url', 'unknown')}"

# Your agent can now call post_meme("Just mass-deployed on a Friday")

const API_KEY = process.env.MEMELAIR_API_KEY!;
const BASE = "https://www.memelair.com/api/v1";
const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

async function generateAndPostMeme(postText: string) {
  // Step 1: AI picks the best meme
  const auto = await fetch(`${BASE}/memes/auto`, {
    method: "POST", headers,
    body: JSON.stringify({ text: postText }),
  }).then((r) => r.json());

  // Step 2: Render it
  const meme = await fetch(`${BASE}/memes/caption`, {
    method: "POST", headers,
    body: JSON.stringify({
      template_id: auto.template_id,
      texts: auto.texts,
    }),
  }).then((r) => r.json());

  // Step 3: Post to X with the meme
  const result = await fetch(`${BASE}/post`, {
    method: "POST", headers,
    body: JSON.stringify({
      text: postText,
      image: meme.url,
    }),
  }).then((r) => r.json());

  console.log("Posted!", result.tweet_url);
  return result;
}

// Usage:
await generateAndPostMeme("Nobody asked for this feature but here it is 😅");

# You can also post plain text — no meme required
curl -X POST https://www.memelair.com/api/v1/post \
  -H "Authorization: Bearer xp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from my agent bot 🤖"}'

# Response: {"success":true,"tweet_id":"...","tweet_url":"..."}

# List templates first
templates = requests.get(
    f"{BASE}/memes",
    headers=HEADERS
).json()["memes"]

# Find one by name
drake = next(t for t in templates if t["id"] == "drake")

# Generate with custom text
meme = requests.post(
    f"{BASE}/memes/caption",
    headers=HEADERS,
    json={
        "template_id": "drake",
        "texts": ["Writing unit tests", "Shipping to prod and praying"]
    }
).json()

image_bytes = base64.b64decode(meme["image_base64"])

{
  "error": "Monthly limit reached (25/25). Upgrade for more.",
  "code": "limit_reached"
}