v1

latestOpenAPI 3.0.3View the license2026-08-0619022.1 KB
Images

Display a custom meme

get/images/{template_id}/{text_filepath}

Path parameters

template_idstring required

ID of a meme template

text_filepathstring required

Lines of text and output extension: <line1>/<line2>/.../<line_n>.<extension>, where n is at most the template's lines value (GET /templates/{id}). Trailing lines may be omitted; pass _ for an empty intermediate line. Path segments must be escape-encoded; prefer POST /images/ with raw text and use the canonical url from the response.

Query parameters

statusinteger

Override the HTTP response status code. Primarily used internally by the POST /images/ → redirect flow to propagate a 201 Created semantic to the final image fetch. Most clients should not need to set this directly.

framesinteger

Maximum number of frames to render in animated output. 0 (default) means no cap. Use this to bound response size and render time on long animations.

scalenumber float

Multiplier applied to the overlay's default size. Most useful with style=<url>.

centerstring

Comma-separated <x>,<y> fractional coordinates (0.0–1.0) for overlay center within its slot. Most useful with style=<url>.

backgroundstring

Custom background image URL. Composes with style=<url> overlays.

colorstring

Comma-separated <text>,<outline> pair. Each value is an HTML color name or hex code (with or without a leading #).

heightinteger

Output height in pixels. See width for combined behavior.

widthinteger

Output width in pixels. If both width and height are supplied, the image is padded to fit while preserving aspect ratio. Values between 1 and 9 are rejected with HTTP 422.

layoutstring

Text layout mode. Allowed values are defined by the API; top places all text at the image top rather than the template's default regions.

fontstring

Font id or alias overriding the template default (GET /fonts/). Unknown values return HTTP 422; the image still renders with the template default font.

stylestring

Alternate visual variant from the template's styles array, OR an HTTPS URL to use as a custom overlay image. For templates with overlays > 1, may be repeated to set each slot independently. Unknown style names return HTTP 422, not the default render.

Response

Successfully displayed a custom meme