Meme LemurDocs

Settings

A team's settings apply to every generate and match call. Read them with GET /v1/settings and change them with PUT /v1/settings.

Read the settings #

GET /v1/settings

Returns your team with its settings.

Shell
curl https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "team": {
    "id": "tnt_hc0n3r4w54a35prf",
    "name": "acme",
    "settings": {
      "steering": "",
      "prohibited": [],
      "tone": "dry, relatable workplace humor",
      "maxWordsPerCaption": 12,
      "blockedTemplateIds": [],
      "blockedTags": [],
      "pinnedTemplateIds": [],
      "useSharedTemplates": true,
      "preferTrending": false,
      "maxDimension": 1200,
      "reuse": "prefer",
      "render": "onRequest",
      "media": "image",
      "gifSize": "small",
      "dailyGenerateCap": 1000,
      "modelCallsPerMinute": 300,
      "modelCallsBurst": null,
      "rendersPerMinute": 600,
      "rendersBurst": null,
      "dataPolicy": "sharedCommons"
    },
    "createdAt": "2026-10-02T00:57:15.705Z"
  },
  "markedUntilPaid": false,
  "caller": { "kind": "apiKey", "keyKind": "regular" }
}

caller says who made the call, so a client can tell what it is allowed to do. For an API key, keyKind is regular or admin. For a signed-in person it is { "kind": "person", "role": "editor" }, with the person's role.

markedUntilPaid is true while your team has not paid, and every meme then gets the Meme Lemur mark: see The Meme Lemur mark.

This route always returns the team's own settings, with or without the Memelemur-Space header. To see what a space runs under, read the space.

Change the settings #

PUT /v1/settings

Send the fields you want to change. The fields you leave out keep their values, and a list in the body replaces the saved list.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "steering": "The audience is a platform team of Go developers.",
    "prohibited": ["layoffs"],
    "blockedTags": ["profanity", "political"]
  }'

The response has the team with the settings as they now are:

JSON
{
  "team": {
    "id": "tnt_hc0n3r4w54a35prf",
    "name": "acme",
    "settings": {
      "steering": "The audience is a platform team of Go developers.",
      "prohibited": ["layoffs"],
      "tone": "dry, relatable workplace humor",
      "maxWordsPerCaption": 12,
      "blockedTemplateIds": [],
      "blockedTags": ["profanity", "political"],
      "pinnedTemplateIds": [],
      "useSharedTemplates": true,
      "preferTrending": false,
      "maxDimension": 1200,
      "reuse": "prefer",
      "render": "onRequest",
      "media": "image",
      "gifSize": "small",
      "dailyGenerateCap": 1000,
      "modelCallsPerMinute": 300,
      "modelCallsBurst": null,
      "rendersPerMinute": 600,
      "rendersBurst": null,
      "dataPolicy": "sharedCommons"
    },
    "createdAt": "2026-10-02T00:57:15.705Z"
  }
}

A change applies to the next call. A signed-in member cannot change the settings. An editor, an owner or an API key of either kind can, except dataPolicy, which only an owner or an admin key can change.

Errors #

Status When
400 A value is out of range or of the wrong type. details says which field.
400 The body would change dailyGenerateCap, watermark, billAfterCredit, chatDailyModelCalls or one of the four rate limit fields. The operator sets them. A body that sends them back as they are saved is accepted, so you can read the settings, change a field and send them all back.
403 The body changes dataPolicy and the caller is not an owner or an admin key.
400 The body sends a watermarkLogo or watermarkLogoDark that is neither null nor the saved one. A logo is set by uploading it.
400, 422, 503 The watermarkText cannot be drawn or was not allowed. See Your watermark.

A field the settings do not have is ignored.

Your data policy #

dataPolicy decides whether other teams can be given the memes your team makes.

Value What happens
sharedCommons The default. A meme the model writes for you goes into the shared pool, and another team with a similar request can be given the same picture and captions. First, an automated check reads the captions and keeps back any that name a client, person, project, codename, internal tool, email address, link, handle or ticket id. The check can miss something. Captions it keeps back, or has not checked yet, stay with your team. A phrase you match is given to another team only when that team sends the same words.
privateVault No other team is given a meme your team makes. Your memes already in the pool are taken out of it when you move, but a team that was given one before keeps it. A creation costs 1.99 cents, or 0.99 cents with your own model key, and there is a monthly fee, agreed with you when you move.

On either policy, other teams never see your prompts, your context or your team's name. Moving back to sharedCommons puts your memes through the check again.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dataPolicy": "privateVault" }'

Your watermark #

A watermark is your name or your logo, drawn on every meme your team makes, so the image says where it came from after somebody saves it. It is on JPEGs and animated GIFs and on the pictures your library keeps. A space can have a mark of its own.

The Meme Lemur mark #

Until your team has paid $10 or more for credit in the last 30 days, every meme gets the Meme Lemur mark in place of yours. The free credit a new team starts with does not count. Your own mark and how it looks stay saved, and are drawn from your next call once you have paid. A team billed after its credit never gets the mark. markedUntilPaid in the settings says whether your memes get it today: false means they get your own mark.

Where it goes #

It goes in the bottom right corner. When a caption is there, it goes in the first of these places that no caption covers: bottom left, top right, top left, then up the right edge and up the left edge.

Text #

Set watermarkText with PUT /v1/settings. An empty string draws no text.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "watermarkText": "acme.example" }'

The text is up to 24 characters, drawn in the font of the captions: white with a dark outline, or black with a white outline at the dark look. That font has Latin letters with their accents, digits and punctuation. A text with any other character, such as Cyrillic or an emoji, returns 400. Use a logo for a name the font cannot write.

The text is checked once, when you set it. It returns 422 when the safety check refuses it, and 503 when the check cannot be made, in which case nothing is saved and you can send it again. A text with the name Meme Lemur in it returns 400.

PUT /v1/settings/watermark-logo

Upload a PNG and it is drawn in place of the text. Send it as the image file of a multipart body, or as JSON with an imageUrl to fetch it from.

Shell
curl -X PUT https://api.memelemur.com/v1/settings/watermark-logo \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -F "image=@logo.png"

The response is the team, as PUT /v1/settings returns it, with the address of the logo:

JSON
{
  "team": {
    "id": "tnt_hc0n3r4w54a35prf",
    "name": "acme",
    "settings": {
      "watermarkText": "acme.example",
      "watermarkLogo": "watermarks/tnt_hc0n3r4w54a35prf/5f2a61c1c0f3a8f3a6a8a0d6c1d1b7f0c9c4b3e79b1a7e1f8f1f6a4f4f0f3f4a.png"
    },
    "createdAt": "2026-10-02T00:57:15.705Z"
  },
  "watermarkLogoUrl": "https://api.memelemur.com/i/watermarks/tnt_hc0n3r4w54a35prf/5f2a61c1c0f3a8f3a6a8a0d6c1d1b7f0c9c4b3e79b1a7e1f8f1f6a4f4f0f3f4a.png"
}

The example leaves out the other settings. A logo is:

  • a PNG of at most 256 KB, which can be see-through around its edges
  • 16 to 512 pixels on each side
  • at most 8 times wider than it is tall, or twice as tall as it is wide

It is drawn as you uploaded it, with no outline added, at about the size the text would be: at the default size a square logo is 101 pixels a side on a 1200 pixel meme and 37 on a small one. Give it its own contrast, such as a dark edge around light letters, so it shows on a light picture and on a dark one, or upload a second logo for light pictures.

A file that breaks one of those limits, or that cannot be read as a PNG, returns 400.

Logo for light pictures #

A logo with light letters is lost on a white picture. Upload a dark version to PUT /v1/settings/watermark-logo with ?variant=dark, and set watermarkTone to dark or auto (see On light and dark pictures). It takes the same files as the logo and is drawn in the logo's place, at the logo's size.

Shell
curl -X PUT "https://api.memelemur.com/v1/settings/watermark-logo?variant=dark" \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -F "image=@logo-dark.png"

The response is the team, with watermarkLogoDark in the settings and watermarkLogoDarkUrl next to watermarkLogoUrl. Any variant other than dark returns 400. The dark logo is drawn only while there is a logo: on its own it does nothing.

Logo in one color #

Set watermarkLogoColor to mono with PUT /v1/settings to draw your logo in a single color, with no second logo to upload. Every visible part of the logo is drawn white at the light look and black at the dark look, and the transparent parts stay transparent. With watermarkTone at auto, your logo is white on dark pictures and black on light ones. original, the default, draws the logo as you uploaded it. A text mark is not affected.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "watermarkLogoColor": "mono", "watermarkTone": "auto" }'

With mono, the logo for light pictures is not drawn, because the black version takes its place. It stays saved, so it is drawn again if you set original. A logo in one color works best when its shape says what it is, since its colors are gone.

Opacity #

Set watermarkOpacity from 0.2 to 1 with PUT /v1/settings. 1, the default, is solid. A lower number lets the picture show through the mark, text or logo.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "watermarkOpacity": 0.6 }'

Below about 0.4 a mark is hard to read on a busy picture.

On light and dark pictures #

Set watermarkTone with PUT /v1/settings:

watermarkTone Text Logo
light, the default White with a black outline The logo
dark Black with a white outline The logo for light pictures, or the logo when there is none
auto Dark where the picture under the mark is light, light where it is dark The logo for light pictures where the picture is light, the logo where it is dark
Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "watermarkTone": "auto" }'

auto looks at the part of the picture the mark covers, after the mark has found its place, so two memes from one template can differ when their captions move the mark.

Size #

Set watermarkSize to small, medium or large with PUT /v1/settings. It sizes your text or your logo, whichever is drawn. medium is the default.

Shell
curl -X PUT https://api.memelemur.com/v1/settings \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "watermarkSize": "large" }'

A mark follows the size of the meme it is on. medium is one and a half times small, and large is one and a half times medium:

Size Text on a 1200 pixel square meme Square logo on it
small 26 pixels 67 pixels a side
medium 40 pixels 101 pixels a side
large 59 pixels 151 pixels a side

The pixels of a text are its font size. Its capital letters are about six sevenths as tall. A large text is close to the size of a meme's smaller captions.

No size is drawn smaller than it can be read. The least a text is drawn at is 13 pixels at small, 14 at medium and 16 at large, and the least a square logo is drawn at is 33, 37 and 40 pixels a side. A small meme is at those sizes or near them, so the three sizes are closer together on it:

Meme Text at small, medium and large Square logo
400 pixel square, such as the small pictures your library keeps 13, 14 and 20 pixels 33, 37 and 50 pixels a side
Animated GIF of 400 by 300 pixels 13, 14 and 17 pixels 33, 37 and 44 pixels a side

A text is fully the size in the first table from about 600 pixels a side at small, 440 at medium and 320 at large.

A mark is never wider than two fifths of the meme at small, three fifths at medium and seven tenths at large. A text too long for that is drawn smaller to fit. On a 1200 pixel square meme 24 characters fit at every size. On a meme that is taller than it is wide a long text at large is drawn smaller: on one of 800 by 1200 pixels that starts at about 21 characters.

A larger mark needs more room, so it is in the bottom right corner less often and up an edge more often. When the captions leave a mark no place at all at its size, it is drawn on that meme at the next size down that has one.

DELETE /v1/settings/watermark-logo

Shell
curl -X DELETE https://api.memelemur.com/v1/settings/watermark-logo \
  -H "Authorization: Bearer $MEMELEMUR_KEY"

Returns the team with watermarkLogo set to null. Your memes then have watermarkText again, or no mark when that is empty. Sending "watermarkLogo": null to PUT /v1/settings does the same. ?variant=dark removes the logo for light pictures, and "watermarkLogoDark": null does the same.

See it on a sample #

GET /v1/settings/watermark-preview

Returns a JPEG of a sample meme with your mark on it. It is drawn as large as your memes are, up to maxDimension, on a popular template you can use that is big enough to show the size. Each of these previews a value you have not saved, and one left out is the saved one:

Parameter Previews
text watermarkText
size watermarkSize
opacity watermarkOpacity
tone watermarkTone
logoColor watermarkLogoColor

background set to light draws the sample on the popular template whose bottom right corner is lightest, and dark on the one whose corner is darkest, so you can see your mark both ways. space previews the mark of a space.

Shell
curl "https://api.memelemur.com/v1/settings/watermark-preview?text=acme.example&tone=auto&background=light" \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -o preview-light.jpg

It counts as one render against rendersPerMinute. It returns 404 when your team has no still template to draw on, and 400 for a value a parameter does not take.

What a change does to memes you already have #

A meme that is already drawn keeps the mark it was drawn with, and so does its URL. A call made after the change returns new URLs, with the new mark. A change of size, opacity or look is a change of mark, so it works the same way.

On a plan where the operator puts the Meme Lemur mark on your memes, watermark is memelemur and that mark is drawn whatever you set here. It is always the size of a small mark, and watermarkSize does not change it. You can still set your own mark and its size, and they are drawn from the day the operator turns theirs off.

The settings fields #

Field Type and default What it does
steering string, up to 4000 characters. Default empty. Free text added to the caption model's instructions: who the audience is, in-jokes, house style.
prohibited up to 100 strings, each up to 200 characters. Default empty. Topics a meme must never mention. The prompt or phrase and the captions are checked against them.
prohibitedThreshold number from 0 to 1, or null. Default null. How sure the check has to be that a text mentions a prohibited topic before the text is refused. null uses 0.66. A lower number refuses more, and a higher number lets more through.
tone string, up to 200 characters. Default dry, relatable workplace humor. The tone of the captions. A generate call can send its own.
maxWordsPerCaption integer, 2 to 40. Default 12. The most words in one caption.
blockedTemplateIds up to 500 template ids. Default empty. Templates that generate and match never use, and that render and a library save refuse.
blockedTags up to 100 tags. Default empty. Generate and match never use a template that has one of these tags, and render and a library save refuse one. Tags lists them.
pinnedTemplateIds up to 100 template ids. Default empty. Templates the caption model is always offered, whatever the search finds.
useSharedTemplates boolean. Default true. Whether your team uses the shared templates. Set it to false to use only your own uploads.
preferTrending boolean. Default false. Whether generate and match move the templates in heavy use this month up the list they choose from. A template the search did not find for the call is never added. Templates says what the score is.
maxDimension integer, 200 to 2000. Default 1200. The longest side of a rendered image, in pixels. A smaller picture is not enlarged.
reuse prefer, never or only. Default prefer. Whether generate and match return memes from the pool.
render onRequest or now. Default onRequest. When generate and match draw their images: right after the call returns, or before it returns. See When the images are drawn.
media image or gif. Default image. What generate, match and render return when a call sends no media: JPEGs, or animated GIFs.
gifSize small or large. Default small. The size of an animated meme. small fits 400 by 300 pixels and large fits 480 by 360, with more frames and colors. Animated memes has both in full.
watermarkText string, up to 24 characters. Default empty. Your name or domain, drawn small in a corner of every meme. See Your watermark.
watermarkLogo the key of an uploaded PNG, or null. Default null. Your logo, drawn in place of the text. You set it by uploading the picture, and null removes it.
watermarkLogoDark the key of an uploaded PNG, or null. Default null. Your logo for light pictures, drawn at the dark and auto looks. You set it by uploading the picture, and null removes it.
watermarkSize small, medium or large. Default medium. How large your text or logo is drawn. See Size.
watermarkOpacity number from 0.2 to 1. Default 1. How solid your mark is. See Opacity.
watermarkTone light, dark or auto. Default light. How your mark looks on light and dark pictures. See On light and dark pictures.
watermarkLogoColor original or mono. Default original. Whether your logo is drawn as uploaded, or in one color, white or black to suit the look. See Logo in one color.
chatCommands an object of generate, match, search and render, each true or false. Default all true. Which /meme commands your Slack and Discord apps answer.
repeatsInSpace allow, avoidPicked or avoidShown. avoidPicked for a new team, allow for a team made before October 2026. Whether generate leaves out memes the same space has already seen, so two people in one community don't get the same meme. avoidPicked leaves out any meme someone in the space picked in the last 90 days, in Slack and Discord too. avoidShown also leaves out what anyone in the space was shown in the last day. The space is the one in the Memelemur-Space header, and a call with none is in your team's no-space scope. Match is not affected, since its words are the caller's.
audienceTags up to 20 tags, each up to 40 lowercase letters, digits and hyphens. Default none. Who a space is for, such as hr or finance. Each call and each signal keeps the tags in force when it was made, so the feedback export can tell which audience picked what.
dataPolicy sharedCommons or privateVault. Default sharedCommons. Whether other teams can be given your memes. See Your data policy. Only an owner or an admin key can change it.
watermark none or memelemur. Default none. Whether the operator puts the Meme Lemur mark on your memes in place of yours. The operator sets it, and you cannot change it here. While your team has not paid it reads memelemur (see The Meme Lemur mark).
dailyGenerateCap integer. Default 1000. How many generate calls a day may reach the caption model on the platform's key. The operator sets it, and you cannot change it here. See the daily cap.
billAfterCredit boolean. False for a new team. What happens once your prepaid credit is used up. True: generate and match calls keep working and are billed. False: they return 402 until credit is added. The operator sets it, and you cannot change it here.
modelCallsPerMinute integer, 1 to 30000. Default 300. How many generate and match calls a minute may ask the caption model. The operator sets it, and you cannot change it here. See rate limits.
modelCallsBurst integer, 1 to 30000, or null. Default null. How many of those calls can come at once. Null is a minute of calls. The operator sets it.
rendersPerMinute integer, 1 to 30000. Default 600. How many render calls a minute your team may make. The operator sets it.
rendersBurst integer, 1 to 30000, or null. Default null. How many render calls can come at once. Null is a minute of calls. The operator sets it.
chatDailyModelCalls integer, or null. Default null. New memes a day each of your Slack and Discord apps may make. Null is 50 until your team pays and 1,000 once it has. The operator sets it, and you cannot change it here.

A request can send its own tone, tags and template choices. It cannot loosen prohibited or the blocklists.

prohibited is enforced by a check of its own, separate from the caption model. Generate and match check the prompt or the phrase first and return 422 when it mentions a topic. Generate then checks the captions of every meme, the ones from the pool included, and leaves out a meme that mentions one. If every meme is left out the call returns 422. When the check cannot be made, the call returns 503 and no meme is returned unchecked.

A prohibited topic also keeps out the shared templates whose sensitive tag is about it: "politics" keeps out templates tagged political. Use blockedTags for anything the wording of a topic does not reach. Render and a library save check the captions you send, and return 422 for captions about a topic. Both return 404 for a template your settings keep out.

A space can override any of these for one community, except watermark, dataPolicy and chatDailyModelCalls, which are the team's in every space.