Memes for AI agents

This guide is written for AI agents and the people who build them. The raw markdown lives at https://memegenscript.com/llms.txt. The OpenAPI document is at https://memegenscript.com/docs/openapi.json.

Make a meme in one request

Send the raw text and let the server do the escaping:

POST https://memegenscript.com/images
Content-Type: application/json

{"template_id": "drake", "text": ["Paying for a meme API", "Writing a URL & done"]}

The response is 201 with the finished image URL:

{"url": "https://memegenscript.com/images/drake/paying_for_a_meme_api/writing_a_url_~a_done.png"}

That URL is the meme. Use it as it is: embed it, post it, or download the bytes. The same URL always renders the same image, and rendered images are cached, so reuse a URL instead of creating it again.

Choose a template

Search by describing the meme or the situation. Every word must match the template's name, aliases, tags, example text, or description:

GET https://memegenscript.com/templates?q=guy+looking+at+girl

Each result has what you need to choose and to build the meme:

If nothing matches, try fewer or different words: search for the feeling (regret, choice, panic) and not only the picture. GET https://memegenscript.com/templates returns every template without descriptions (about 200 KB), and GET https://memegenscript.com/templates/{id} returns one.

Write text that fits

• The order of the text array is the order of the slots. Look at example.text to see which slot is which: on drake the first string is the rejected option and the second is the preferred one.
• Keep each line short, about 60 characters or less. Text shrinks to fit its box, so long lines become hard to read.
• Use an empty string to leave a slot blank, for example ["", "bottom text only"].
• Text is drawn in uppercase on most templates.
• Emoji work, either as the character or as a shortcode such as :thumbsup:.

Build the URL yourself

You can skip the POST and write the URL directly:

https://memegenscript.com/images/{id}/{line_1}/{line_2}.{ext}

{ext} is png, jpg, gif, or webp. Escape each line with these rules:

Example: https://memegenscript.com/images/fry/not_sure_if_bug/or_feature~q.png

If the text has any punctuation, prefer the POST. It applies these rules for you.

Options

Add these as query parameters to any image URL, including a URL that the POST returned:

The POST body also accepts font, style, layout, and extension, and puts them in the URL for you.

The extension sets the format: png and jpg are still images, gif and webp are animated. Templates with an animated style default to gif, which is larger and slower to render. Send "extension": "png" when you want a still image.

Use your own image

Put text on any image with the custom template:

POST https://memegenscript.com/images/custom
Content-Type: application/json

{"background": "https://example.com/photo.jpg", "text": ["top text", "bottom text"]}

The image URL must be public. Keep the image small: a large photo is slow to download and render.

Meme characters (transparent PNGs)

Besides captioned templates, the site has classic meme characters (Doge, Wojak, Pepe, Trollface, Gigachad, …) cut out as transparent PNGs, for stickers, overlays, and images you compose yourself:

GET https://memegenscript.com/characters?q=frog

Each result has id, name, aliases, description, width, height, the image URL of the PNG, and templates (the meme templates the character appears in). The image URL is https://memegenscript.com/characters/{id}.png; add ?width=400 or ?height=400 to resize (the aspect ratio is kept). The background is transparent, so put the PNG on your own image or colour. GET https://memegenscript.com/characters lists all of them and GET https://memegenscript.com/characters/{id} returns one. People can browse them at https://memegenscript.com/meme-characters.

Post it

• Platforms that show link previews, and chat apps such as Discord or Slack, render the URL as an image. Send the URL.
• Platforms that need an upload: GET the URL, then upload the bytes. The content type is image/png, image/jpeg, image/gif, or image/webp, to match the extension.
• To let a person adjust the result, send them to the editor page for the template: https://memegenscript.com/memes/{id}.

Errors

Check the HTTP status code. A failed image URL still returns an image (a picture of the error) with the error status, so a 200 is the only proof that the meme rendered. A POST with an unknown template_id returns 404 together with a url. Do not use that URL.

Rules of the road

• The service is free and shared. Cache the template search results you use, reuse the URLs you have made, and do not render in bulk what you will not post.
• Template images belong to their respective owners. You are responsible for what you post.
• Missing a template? Ask for it: https://forms.gle/SbsPFknn9NRUjs3P6

Instructions to give your agent

Paste this into your agent's system prompt or skill file:

You can make memes with Memegenscript (https://memegenscript.com). No API key is needed.
1. Find a template: GET https://memegenscript.com/templates?q=<words describing the meme or the situation>.
   Read "description" and "example.text" to check that the joke fits. Note "id" and "lines".
2. Create the meme: POST https://memegenscript.com/images with JSON
   {"template_id": "<id>", "text": ["<slot 1>", "<slot 2>"]}
   Send at most "lines" strings, each about 60 characters or less.
3. The response {"url": "..."} is the finished image. Post that URL, or download it to upload.
Never invent a template ID. Only a 201 from the POST and a 200 from the image URL mean success. Full guide: https://memegenscript.com/llms.txt