xtract.bot
POST /api/image-gif-to-ascii

Convert the first frame of a GIF to ASCII art. Configurable width, character ramp, invert mode. Plain text or coloured HTML output.

Decodes the first frame of an animated or static GIF and renders it as ASCII art. Same options and output formats as `image-png-to-ascii`. For per-frame ASCII art of an animated GIF, run `gif-extract-frames` first then feed each PNG through `image-png-to-ascii`.

Inputs

NameTypeDefaultDescription
image*fileGIF bytes.
widthnumber (8…400)80Output character columns (default 80).
rampstring"standard"Preset name (standard|blocks|detailed) or a custom ramp string of at least two characters.
invertbooleanfalseFlip the luminance→character mapping.
formatenum (text | html)"text"`text` for plain ASCII; `html` for a coloured <pre> document.

Response

Modes: text, json. Cache: yes (24h TTL).