developer-api
memes
uploads

Upload an image, place top or bottom caption boxes, and store the hosted meme

Changed on

Accepts a PNG, JPEG, or WebP source plus caption placement JSON, renders the meme, and returns hosted URLs. Anonymous requests use free rate limits.

post/api/v1/memes/caption-upload

Request

  • Base URL
    https://memesio.com
  • URL
    https://memesio.com/api/v1/memes/caption-upload
  • Auth
    • none
    • or API key in header x-developer-api-key
    • or API key in header x-agent-api-key

Request body multipart/form-data

filestring binary required
captionsstring required

JSON array of caption slot objects with text, x, y, boxWidthPct, boxHeightPct, fontSize, and alignment fields.

titlestring
visibility'private' | 'public'
watermarkstring

Optional JSON watermark object. Non-premium callers are forced to the default Memesio watermark; premium callers can customize enabled, text, position, and scale.

Response

Uploaded meme created

oktrue required

Changes