Image to Ascii Art by URL API

Convert an image to ASCII art. You can pass the image URL as a query parameter. The API returns the ASCII art as plain text. This endpoint is using the GET method and an image URL as a query parameter.

Make sure to read about the best art APIs to supplement your app.

GET

https://api.apileague.com/convert-image-to-ascii-txt

Parameters

Name	Example	Description
`url` s r q	https://upload.wikimedia.org/wikipedia/commons/3/35/Basic_human_drawing.png	The URL to the image.
`width` n o q	200	The maximum width of the image (default 400, max. 500).
`height` n o q	200	The maximum height of the image (default 400, max. 500).
`api-key` s r q	abcd1234	Your API key.

Example Request and Response

GET

https://api.apileague.com/convert-image-to-ascii-txt?url=https://upload.wikimedia.org/wikipedia/commons/3/35/Basic_human_drawing.png&width=200&height=200

.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
..............................................,,,,,,,,...........................................
...........................................:+?%%%%%%%%*;,........................................
........................................,+%###S%????SS##S?;......................................
.......................................*S@#*;;:,,,,,::;+%##%;....................................
.....................................:%@S+:,............,;?##*,..................................
...................................,+##*,.................,;%#%:.................................
...................................*@S:.....................,*##;................................
..................................*#%:........................;#S;...............................
.................................*@%,..........................;#S:..............................
................................;#S:............................+@?,.............................
...............................,%#;..............................?#;.............................
...............................+#+...............................,SS,............................
..............................:S%,................................+@*............................
..............................+#+.................................,S#:...........................
.............................,?#:..................................*@*...........................
.............................,S?...................................,@%...........................
.............................:#+....................................%#,..........................
.............................;#;....................................+#:..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................:#;....................................*#:..........................
.............................:#*....................................SS,..........................
.............................,%%,..................................,@%...........................
..............................*#:..................................?@+...........................
..............................;#*.................................:##,...........................
..............................,%S,................................*@*............................
...............................;#*...............................:S%,............................
...............................,?#+.............................,%#:.............................
................................:##;............................*@*..............................
.................................+#S:..........................*#%,..............................
..................................;#S:.......................,*@%:...............................
...................................;SS+,....................:?#%:................................
....................................:%@S+.................,*##*,.................................
.....................................,+#@%;.............,*S@S;...................................
.......................................:?#@S?+;:,,,,:;*%#@S+,....................................
.........................................,+%#@@#####@@@#%;,......................................
............................................:+*?S#@S?*;,.........................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................:S@?,............................................
...............................................,?@@@+............................................
...............................................*#@@@S:...........................................
..............................................*@%%@@@?...........................................
.............................................+@S;?S%@#;..........................................
............................................+@#;,%S;%@S,.........................................
...........................................:##;.,%#::#@*.........................................
..........................................:##;..,%#:.*@#;........................................
.........................................;##;...,%#:.,%@S,.......................................
........................................:S#+....,%#:..:S@*.......................................
.......................................,%#*.....,%#:...+@#;......................................
......................................,%#*......,%#:...,%@S,.....................................
.....................................:%@+.......,%#:....:S@*.....................................
....................................,%@*........,%#:.....+@#;....................................
...................................,*@?,........,%#:.....,?@%,...................................
...................................*#?,.........,%#:......:%#+...................................
..................................*@?,..........,%#:.......;#S:..................................
................................,*@%,...........,%#:.......,*@?..................................
................................+@#;............,%#:........:S@+.................................
...............................;##;.............,%#:.........+#S:................................
..............................;S#;..............,%#:.........,?@*,...............................
.............................:S#;...............,%#:..........,%#;...............................
............................:#@*................,%#:...........:#%:..............................
...........................:#@*.................,%#:............*@*..............................
..........................,%@?..................,%#:............,SS:.............................
.........................,%@?...................,%#:.............;#?,............................
........................:%@?....................,%#:..............?@*............................
.......................:%@%,....................,%#:..............,##;...........................
......................,%@%,.....................,%#:...............;#S,..........................
......................*@S:......................,%#:................+@?..........................
....................,*@S:.......................,%#:.................?#;.........................
...................,*@S:........................,%#:.................:SS,........................
...................*@%:.........................,%#:..................+@?........................
..................+@%,..........................,%#:..................,%#;.......................
.................;#S:...........................,%#:...................:#S:......................
................:##;............................,%#:....................+@?,.....................
...............:S#;.............................,%#:....................,?#+.....................
..............;##;..............................,%#:.....................:SS:....................
.............:S#;...............................,%#:......................+#?,...................
............,%@+................................,%#:......................,?#+...................
...........,%@*.................................,%#:.......................:SS:..................
...........?@*..................................,%#:........................+#*..................
...........+*...................................,%#:........................,*;..................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................+#@+.............................................
...............................................;SS##;............................................
..............................................+#%;+#S;...........................................
.............................................+#S;..?@S:..........................................
............................................;#S;...,%@%,.........................................
..........................................,*#S:.....,%@?.........................................
.........................................,?@S:.......:S@*........................................
.........................................?@S:.........:S@+.......................................
........................................?@S:...........:##;......................................
.......................................?@S:.............+@#;.....................................
......................................?@S:...............+@S:....................................
....................................,?@S;.................*@%,...................................
...................................,*@S:...................*@*,..................................
..................................,?#%:....................,?#*..................................
.................................:%@?,......................,%#+.................................
................................:%@?,........................:S#;................................
...............................:%@?,..........................;##;...............................
..............................:%@?,............................+#S:..............................
.............................,%@?,..............................+#%..............................
............................,S@?,...............................,?@?.............................
...........................,S@%,.................................,%@;............................
..........................:S@*,...................................:S@;...........................
.........................;S#+......................................;S#:..........................
........................+#S;........................................:#S:.........................
.......................;##:..........................................;@%,........................
......................;##;............................................+@*........................
.....................;##:.............................................,%@*.......................
....................;##;...............................................,%#+......................
...................;#S;.................................................,S#;.....................
..................;S#;...................................................:#S:....................
.................+S#;.....................................................+#%:...................
...............,*#S;.......................................................+#?,..................
..............,*#%,.........................................................*#?,.................
.............,*@%,..........................................................,?@*.................
.............;@?,............................................................:%#:................
.............:*,..............................................................:+,................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................

cURL

Java

Javascript

Python

 Copy Codecurl -X GET 'https://api.apileague.com/convert-image-to-ascii-txt?url=https://upload.wikimedia.org/wikipedia/commons/3/35/Basic_human_drawing.png&width=200&height=200' \ -H 'x-api-key: myapikey'

Headers

Response Headers:

Content-Type: text/plain
X-API-Quota-Request: The number of tokens used by the request
X-API-Quota-Used: The number of tokens used in total today
X-API-Quota-Left: The number of tokens left today (depends on your plan)

Quotas

Calling this endpoint costs

5 tokens

Image to Ascii Art by Image File API

Convert an image to ASCII art. You can pass the image as body to the API. This endpoint is using the POST method and the actual image file as the body of the request.

Please make sure to set the 'Content-Type' header to either 'image/jpeg' or 'image/png' depending on the image type.

POST

https://api.apileague.com/convert-image-to-ascii-txt

Parameters

Name	Example	Description
`(body)` f r b		The binary image
`width` n o q	200	The maximum width of the image (default 400, max. 500).
`height` n o q	200	The maximum height of the image (default 400, max. 500).
`api-key` s r q	abcd1234	Your API key.

Example Request and Response

POST

https://api.apileague.com/convert-image-to-ascii-txt

.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
..............................................,,,,,,,,...........................................
...........................................:+?%%%%%%%%*;,........................................
........................................,+%###S%????SS##S?;......................................
.......................................*S@#*;;:,,,,,::;+%##%;....................................
.....................................:%@S+:,............,;?##*,..................................
...................................,+##*,.................,;%#%:.................................
...................................*@S:.....................,*##;................................
..................................*#%:........................;#S;...............................
.................................*@%,..........................;#S:..............................
................................;#S:............................+@?,.............................
...............................,%#;..............................?#;.............................
...............................+#+...............................,SS,............................
..............................:S%,................................+@*............................
..............................+#+.................................,S#:...........................
.............................,?#:..................................*@*...........................
.............................,S?...................................,@%...........................
.............................:#+....................................%#,..........................
.............................;#;....................................+#:..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................:#;....................................*#:..........................
.............................:#*....................................SS,..........................
.............................,%%,..................................,@%...........................
..............................*#:..................................?@+...........................
..............................;#*.................................:##,...........................
..............................,%S,................................*@*............................
...............................;#*...............................:S%,............................
...............................,?#+.............................,%#:.............................
................................:##;............................*@*..............................
.................................+#S:..........................*#%,..............................
..................................;#S:.......................,*@%:...............................
...................................;SS+,....................:?#%:................................
....................................:%@S+.................,*##*,.................................
.....................................,+#@%;.............,*S@S;...................................
.......................................:?#@S?+;:,,,,:;*%#@S+,....................................
.........................................,+%#@@#####@@@#%;,......................................
............................................:+*?S#@S?*;,.........................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................:S@?,............................................
...............................................,?@@@+............................................
...............................................*#@@@S:...........................................
..............................................*@%%@@@?...........................................
.............................................+@S;?S%@#;..........................................
............................................+@#;,%S;%@S,.........................................
...........................................:##;.,%#::#@*.........................................
..........................................:##;..,%#:.*@#;........................................
.........................................;##;...,%#:.,%@S,.......................................
........................................:S#+....,%#:..:S@*.......................................
.......................................,%#*.....,%#:...+@#;......................................
......................................,%#*......,%#:...,%@S,.....................................
.....................................:%@+.......,%#:....:S@*.....................................
....................................,%@*........,%#:.....+@#;....................................
...................................,*@?,........,%#:.....,?@%,...................................
...................................*#?,.........,%#:......:%#+...................................
..................................*@?,..........,%#:.......;#S:..................................
................................,*@%,...........,%#:.......,*@?..................................
................................+@#;............,%#:........:S@+.................................
...............................;##;.............,%#:.........+#S:................................
..............................;S#;..............,%#:.........,?@*,...............................
.............................:S#;...............,%#:..........,%#;...............................
............................:#@*................,%#:...........:#%:..............................
...........................:#@*.................,%#:............*@*..............................
..........................,%@?..................,%#:............,SS:.............................
.........................,%@?...................,%#:.............;#?,............................
........................:%@?....................,%#:..............?@*............................
.......................:%@%,....................,%#:..............,##;...........................
......................,%@%,.....................,%#:...............;#S,..........................
......................*@S:......................,%#:................+@?..........................
....................,*@S:.......................,%#:.................?#;.........................
...................,*@S:........................,%#:.................:SS,........................
...................*@%:.........................,%#:..................+@?........................
..................+@%,..........................,%#:..................,%#;.......................
.................;#S:...........................,%#:...................:#S:......................
................:##;............................,%#:....................+@?,.....................
...............:S#;.............................,%#:....................,?#+.....................
..............;##;..............................,%#:.....................:SS:....................
.............:S#;...............................,%#:......................+#?,...................
............,%@+................................,%#:......................,?#+...................
...........,%@*.................................,%#:.......................:SS:..................
...........?@*..................................,%#:........................+#*..................
...........+*...................................,%#:........................,*;..................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................+#@+.............................................
...............................................;SS##;............................................
..............................................+#%;+#S;...........................................
.............................................+#S;..?@S:..........................................
............................................;#S;...,%@%,.........................................
..........................................,*#S:.....,%@?.........................................
.........................................,?@S:.......:S@*........................................
.........................................?@S:.........:S@+.......................................
........................................?@S:...........:##;......................................
.......................................?@S:.............+@#;.....................................
......................................?@S:...............+@S:....................................
....................................,?@S;.................*@%,...................................
...................................,*@S:...................*@*,..................................
..................................,?#%:....................,?#*..................................
.................................:%@?,......................,%#+.................................
................................:%@?,........................:S#;................................
...............................:%@?,..........................;##;...............................
..............................:%@?,............................+#S:..............................
.............................,%@?,..............................+#%..............................
............................,S@?,...............................,?@?.............................
...........................,S@%,.................................,%@;............................
..........................:S@*,...................................:S@;...........................
.........................;S#+......................................;S#:..........................
........................+#S;........................................:#S:.........................
.......................;##:..........................................;@%,........................
......................;##;............................................+@*........................
.....................;##:.............................................,%@*.......................
....................;##;...............................................,%#+......................
...................;#S;.................................................,S#;.....................
..................;S#;...................................................:#S:....................
.................+S#;.....................................................+#%:...................
...............,*#S;.......................................................+#?,..................
..............,*#%,.........................................................*#?,.................
.............,*@%,..........................................................,?@*.................
.............;@?,............................................................:%#:................
.............:*,..............................................................:+,................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................

Headers

Request Headers:

Content-Type: image/jpeg

Response Headers:

Content-Type: text/plain
X-API-Quota-Request: The number of tokens used by the request
X-API-Quota-Used: The number of tokens used in total today
X-API-Quota-Left: The number of tokens left today (depends on your plan)

Quotas

Calling this endpoint costs

5 tokens

Image to Ascii Art by URL API

Parameters

Headers

Quotas

Image to Ascii Art by Image File API

Parameters

Headers

Quotas

Info

API Resources

Awesome APIs