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:
export MEMELEMUR_KEY="ml_your_key_here"Send a prompt to generate:
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:
{
"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:
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. |
What to read next #
- 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.