名称	参数	必填	说明
开发者ID	id	是	用户中心的数字ID，例：id=10000000
开发者KEY	key	是	用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2
源图像	img	是	图像格式JPG,PNG,GIF。可以是网络图片地址，也可以传BASE64编码格式图片，编码必须带头部信息，编码后的数据不能超过1M。例：img=https://down.erguanmingmin.com/img/zhanghanyun.jpeg
背景颜色	bjcolour	否	背景颜色代码十六进制，不加#号，例：bjcolour=ffffff
文本颜色	xscolour	否	像素块颜色代码十六进制，不加#号，例：xscolour=000000
图片宽度	width	否	生成后的图片宽度，会根据比例自动调整高度，不超过1024，默认500，图片宽度也会影响图片风格，不同大小也会有不同的效果。例：width=500
图片灰度	duibi	否	生成图片的对比度灰度值，范围1-1000，默认220，不同的源图片颜色深度不同，需要通过灰度值来调整，建议在200-300左右，图片灰度不同的效果不一样，请自行测试。例：duibi=220
图片风格	type	否	生成图片的风格，预设50种风格，范围1-50，默认1号风格，请自行测试。例：type=1
动态秘钥	dkey	否	开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IP	uip	否	接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。

返回参数说明

名称	参数	说明
状态码	code	200成功，400错误
信息提示	msg	信息提示。
图片地址	img	转换后的图片地址，请尽快保存，该图片地址会定期清理。

返回数据示例

示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：{"code":200,"msg":"生成图像成功，请尽快保存.","url":"https://res.apihz.cn/asciiimg/img2/999.jpg"}

更新记录

2024-09-29 17:43:13 - 新增接口。

图像处理-图片转ASCII图片(像素图，艺术图)-2024-09-30 15:06:00

将指定图片转换成ASCII风格图片，像素风格图片。

使用协议：接口盒子提供的所有服务不得用于任何违法行为。接口盒子提供的信息，使用者应当自行判断准确性，适用性。使用者所造成的一切后果责任，损失等，由使用者自行承担。从使用接口盒子的服务起默认遵守此协议。

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	1000
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	1502
今日总计调用	300
昨日总计调用	493
历史总计调用	547885
今日排名	174
总排名	174

自检信息

自检日志

自检启用状态	已启用
自检节点	上海
自检线路	彩钻接口线路
自检时间	2026-07-23 17:37:21
自检耗时	494 毫秒
自检状态	正常
历史自检成功数	252300 次
历史自检失败数	180 次
历史自检成功率	99.93 %
今日自检成功数	298 次
今日自检失败数	0 次
今日自检成功率	100.00 %

图像处理-相关接口

状态启用 ID 377 TOPD 91 免费

图片压缩+格式转换

将指定图片压缩或进行格式转换。