ASCII art API

Send image bytes or text to POST /api/v1/ascii. Responses contain only the rendered ASCII grid and its dimensions.

Image request

curl -X POST https://gimmeascii.com/api/v1/ascii \
  -F image=@photo.jpg \
  -F cols=80 \
  -F charset=Standard

Text request

curl -X POST https://gimmeascii.com/api/v1/ascii \
  -H 'content-type: application/json' \
  -d '{"text":"HELLO","fontFamily":"sans-serif","cols":80}'

Command line

The source checkout includes a CLI that calls the hosted API by default. Add --local to process the image on your machine.

pnpm nx run gimme-ascii-cli:run -- photo.jpg --cols 80 --charset Blocks
pnpm nx run gimme-ascii-cli:run -- photo.jpg --local

Use - in place of the file name to read stdin. Add --text when the input is UTF-8 text.

Options

Name	Values
`cols`	1 to 400, default 80
`rows`	1 to 400, or automatic
`charset`	Preset name or custom character ramp
`invert`	Boolean
`color`	Boolean; returns cells with RGB values

Uploads are capped at 8MB. Remote URL inputs are not accepted.