Meme LemurDocs

Meme Lemur API docs

Meme Lemur turns a prompt or a phrase into a finished meme. Make your first one with an API key and one curl command.

What Meme Lemur does #

Meme Lemur makes memes on pictures people already know, such as Drakeposting or Distracted Boyfriend. You send a prompt, and it picks the templates that fit, writes the captions with Claude, and returns each meme as a JPEG at a URL. If you already have the words, you send the phrase and it goes on a template as you wrote it. If you already have the template and the captions, it draws them.

Your team also gets a library of saved memes it can search, settings that say what a caption may mention, templates of its own next to more than 500 shared ones, a record of what members voted up and posted, and a count of what it used each day.

Make your first meme #

You need an API key. A key starts with ml_. If you do not have one, ask for access on the home page.

Put the key in a variable, so the commands on every page work as they are written:

Shell
export MEMELEMUR_KEY="ml_your_key_here"

Send a prompt to generate:

Shell
curl https://api.memelemur.com/v1/generate \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "when the deploy goes out at 4:55pm on a Friday", "count": 1}'

The response has one meme:

JSON
{
  "generationId": "gen_lm3cb7x1cxp14mna",
  "memes": [
    {
      "key": "renders/tnt_hc0n3r4w54a35prf/af658530e5411f8f682cd40ffc808c1bc5e172dfd9a80e577d2c28dd7a2dc3ca.jpg",
      "url": "https://api.memelemur.com/i/renders/tnt_hc0n3r4w54a35prf/af658530e5411f8f682cd40ffc808c1bc5e172dfd9a80e577d2c28dd7a2dc3ca.jpg",
      "width": 446,
      "height": 698,
      "templateId": "tpl_kwhxl4k7tqhc25ds",
      "templateName": "Drakeposting",
      "captions": ["Deploying on Monday morning", "Deploying at 4:55pm on a Friday"],
      "source": "generated",
      "id": "shown_os3512168bmpdyq3"
    }
  ],
  "elapsedMs": 2840
}

url is the finished image. It needs no key, so you can open it in a browser or put it in a message as it is. To save a copy:

Shell
curl -o meme.jpg "https://api.memelemur.com/i/renders/tnt_hc0n3r4w54a35prf/af658530e5411f8f682cd40ffc808c1bc5e172dfd9a80e577d2c28dd7a2dc3ca.jpg"

Keep the meme's id. When someone posts the meme or votes on it, send that id to feedback, and the counts tell you which templates your audience likes.

A generate call usually returns in a few seconds. Generate lists every field you can send, and Limits and errors lists what a failed call returns.

The names the API uses #

Name What it is
Team Your account. An API key belongs to one team, and a key can read and change only what that team owns.
Template A picture with places for captions. Every team can use the shared templates, and a team can upload its own.
Box One place on a template where a caption is drawn. A template has 1 to 12 boxes.
Slot The caption that goes in one box. A template with two boxes has two slots, so it takes two captions, in the order of its boxes.
Space A scope inside a team, for one that runs several communities. A space has its own settings, its own library and its own counts.
Pool The memes that generate and match have already made on shared templates. Generate looks there first, and returns a meme that fits without calling the caption model.
Owner, editor and member The three roles a person can have in a team. A member can make memes and read most things. An editor can also change settings, spaces and regular API keys. An owner can do everything, which includes inviting people.
Regular key and admin key The two kinds of API key. A regular key makes memes and changes settings and spaces. An admin key can also manage people, the team's model key and the API keys.
Operator Whoever runs Meme Lemur for you. The operator creates teams and sets each team's daily cap.
  • Authentication has the base URL, the header, and how ids and times are written.
  • Match puts words you already have on a meme, and Render draws captions you chose on a template you chose.
  • Templates covers searching the templates and uploading your own.
  • Settings and Spaces say what captions may mention, for the team and for each community.