---
title: "Display a template background"
method: GET
path: "/images/{template_filename}"
tags: ["Images"]
---

# Display a template background

`GET /images/{template_filename}`

## Request

- Base URL: `https://api.memegen.link` (the document declares no server; this is the origin it was published from)
- URL: `https://api.memegen.link/images/{template_filename}`
- Auth: API key in header `X-API-KEY`

## Path parameters

- `template_filename` string, required

## Query parameters

- `status` integer
- `frames` integer
- `scale` number, float
- `center` string
- `background` string
- `color` string
- `height` integer
- `width` integer
- `layout` string
- `font` string
- `style` string

## Response `200`

Successfully displayed a template background

## Other responses

- `404`: Template not found
- `415`: Unable to download image URL
- `422`: Invalid style for template or no image URL specified for custom template

## Changes

- **2026-06-14** `6536f03bb685`: 11 info
  - added the new optional `query` request parameter `background`
  - added the new optional `query` request parameter `center`
  - added the new optional `query` request parameter `color`
  - added the new optional `query` request parameter `font`
  - …7 more
- **2024-07-20** `0efdefb4a228`: 3 info
  - api operation id `get~images.detail_blank` removed and replaced with `get~Images.detail_blank`
  - api tag `Images` added
  - api tag `images` removed

[Operation history](https://skmtc.dev/memegen/apis/memegen-link/changes/images/:template_filename/get.md)

---

[API](https://skmtc.dev/memegen/apis/memegen-link.md) - [All operations](https://skmtc.dev/memegen/apis/memegen-link/llms.txt) - [OpenAPI document](https://skmtc.dev/memegen/apis/memegen-link/revisions/abf08826a907?raw)
