Display a template background

Template ID and image format: <template_id>.<extension>. This is the canonical empty-template render and matches the blank field on GET /templates/{id}. Use this when a client just wants the background. The same query parameters as /images/{template_id}/{text_filepath} apply.

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.

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.

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

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

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

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

Output height in pixels. See width for combined behavior.

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.

Text layout: default or top. The top layout places all text at the top of the image rather than in the template's default text regions.

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

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.