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.

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