SUsupermeme
Meme V2

Generate meme images v2

Generates ready-to-use meme images with captions rendered in. Returned URLs are signed and expire after 1 hour (see expiresAt) — download or re-host promptly.

post/api/v1/meme/image

Request

  • Base URL
    https://app.supermeme.ai
  • Auth
    HTTP bearer

Request body

textstring required

Text to convert to meme images (max 2,500 characters)

countnumber

Number of memes to generate, up to 12 (optional). Normalized server-side: non-integer values are truncated, values above 12 are clamped to 12, values below 1 are rejected.

aspectRatio'1:1' | '3:4' | '4:3' | '9:16' | '16:9'

Aspect ratio for the generated images (optional)

paddingColorstring

Hex color for aspect ratio padding (optional, defaults to #FFFFFF)

Example request

{
  "text": "When the code works on the first try"
}

Response

Meme images generated successfully

memesstring[] required

Signed URLs of the generated meme images (captions are rendered into the image)

expiresAtstring required

Conservative ISO 8601 expiry for the returned image URLs (signed with a 1-hour TTL). The URLs are guaranteed valid until this time; treat them as expired after it.

Example response

{
  "expiresAt": "2026-01-01T13:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.