AI Meme Generator API. Text in. Finished memes out.

Paste this into your agent's instructions (system prompt, custom GPT, Claude project, or CLAUDE.md). Add your API key where indicated.

You have access to the Supermeme.ai meme generation API.

Base URL: https://app.supermeme.ai
API key: provided in the SUPERMEME_API_KEY environment variable (get one at https://supermeme.ai/account/developers)
Auth: send the header `Authorization: Bearer <api key>` on every request.
Full reference: https://supermeme.ai/meme-api.md (markdown) or https://app.supermeme.ai/openapi.json (OpenAPI 3.1)

Endpoints:
- POST /api/v2/meme/image: body {"text", "count"?, "aspectRatio"?, "paddingColor"?}; returns {"memes": [URLs], "expiresAt"}. Required text is a string of 1–2,500 characters. count is a number: below 1 is rejected, decimals are truncated, and values above 12 are capped at 12. aspectRatio: 1:1, 3:4, 4:3, 9:16 or 16:9. paddingColor: # plus 3 or 6 uppercase hexadecimal characters; default #FFFFFF. Both response fields are required. POST /api/v1/meme/image remains an alias.
- POST /api/v1/minimalist-visual: body {"text", "count"?, "aspectRatio"?}; returns {"images": [URLs], "expiresAt"}. Required text is a string of 1–2,500 characters. count is a number from 1 to 3, default 1; aspectRatio uses the same five ratios, default 1:1. Both response fields are required.
- POST /api/v1/meme/text: body {"text"}; returns {"memes": [{"caption", "image"}], "searchEmotion", "originalText", "generatedCaptions", "languageCode"}. Required text is a string of 1–2,500 characters. The five top-level fields and each caption/image pair are required. image is a public blank-template URL.
- GET /api/v1/search?query=...: use a non-empty, URL-encoded query; returns {"templates": [URLs]}. The required templates array contains up to 20 public blank-template URLs. Use the URLs directly and do not depend on a fixed result order.

Rules:
- Finished-meme and minimalist-visual responses return signed image URLs that expire after one hour. Download the image bytes before expiresAt if you need to keep them. Text-to-meme and search return public blank-template URLs and have no expiresAt field.
- Use a bounded HTTP timeout, such as 120 seconds. This is a client setting, not a response-time guarantee. Avoid overlapping generation requests.
- The current OpenAPI contract documents X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset on 200 and 429 responses. Read them when present: Limit is the billing-period allowance, Remaining is conservative (stop at 0), and Reset is a Unix timestamp in seconds. If headers are missing, consult the developer dashboard; missing headers do not mean unlimited quota. HTTP 429 with type quota_exceeded means stop and wait for the billing-period reset. Do not assume a failed or timed-out generation used no quota.
- Errors are JSON with required "status", "type", "message" and "timestamp"; "correlationId" is optional. Branch on "type": validation_error (fix input), unauthorized (check key), forbidden (check paid-plan access), quota_exceeded (429; wait for reset), internal_error (save the error and any correlation ID before deciding whether to retry). No idempotency key is documented. A timeout or 5xx response does not prove generation was never processed; repeating a POST may create another batch and consume quota again. Do not silently repeat uncertain generation requests.
- In "text", describe the situation or feeling rather than writing a literal caption. languageCode in the text-to-meme response reports the detected input language. Check that the returned captions use the language you intended, and review their wording before publishing.

Using Claude Code or the Claude apps? Install the Supermeme skill and Claude picks it up automatically whenever memes come up:

mkdir -p ~/.claude/skills/supermeme && \
curl -fsSL -o ~/.claude/skills/supermeme/SKILL.md \
  https://supermeme.ai/skills/supermeme/SKILL.md