图片API

图汇API提供多种类型的图片接口服务，包括动漫、风景、真人、CosPlay等多个分类。所有接口支持以下特点：

支持多种终端适配（手机端、电脑端、自适应）
支持多种返回格式（JSON、直接图片）
高速全球CDN加速
稳定可靠的服务保障
免费无限制调用

100W+

优质图片资源

99.9%

服务可用性

10K+

活跃用户

使用须知

建议在Header中添加referer防盗链
图片内容均来源于网络，如有侵权请联系删除
禁止用于商业用途
使用前请阅读完整的服务条款

GET 请求方式

真人/动漫/风景调用

https://api.hn/api.php

请求参数

参数名	必填	类型	说明
zd	否	string	输出壁纸的终端[mobile\|pc\|zsy] 为空输出pc 竖图\|横图\|自适应
fl	否	string	选择输出分类[meizi\|dongman\|fengjing\|suiji] 为空随机输出
gs	否	string	输出壁纸格式[json\|images] 默认为images

返回参数

参数名	类型	说明
code	string	返回的状态码
imgurl	string	返回图片地址
width	string	返回图片宽度
height	string	返回图片高度

返回示例

{
    "code": "200",
    "imgurl": "https://tva4.sinaimg.cn/large/9bd9b167gy1g2qkr95hylj21hc0u01kx.jpg",
    "width": "1920",
    "height": "1080"
}

GET 请求方式

CosPlay调用

https://api.hn/cos.php

请求参数

参数名	必填	类型	说明
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro]，默认url
json	否	string	返回一条标准json数据(图片地址)
jsonpro	否	string	返回十条标准json数据(图片地址)
url	否	string	直接返回一条图片链接
urlpro	否	string	直接返回十条图片链接
img	否	string	直接显示图片不返回图片链接

返回参数

参数名	类型	说明
API_name	string	API名称
imgurl	string	返回图片地址
width	string	返回图片宽度
height	string	返回图片高度

返回示例

{
    "API_name": "COS_API",
    "imgurl": "https://img.m4a1.top/api.hn/\u5c11\u5973\u79e9\u5e8f VOL.010/13.jpg",
    "width": "3369",
    "height": "2146"
}

GET 请求方式

二次元ACG_API调用

https://api.hn/acg.php

请求参数

参数名	必填	类型	说明
zd	否	string	设备类型 [mobile\|pc\|zsy] 默认为 `zsy`。自动适配设备。
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro] 默认 `img`。
json	否	string	返回一条标准 JSON 数据（图片地址）。
jsonpro	否	string	返回十条标准 JSON 数据（图片地址）。
url	否	string	直接返回一条图片链接。
urlpro	否	string	直接返回十条图片链接。
img	否	string	直接显示图片，不返回图片链接。
imgpro	否	string	直接显示多张图片，不返回图片链接。

返回参数

参数名	类型	说明
API_name	string	API 名称。
imgurl	string	返回图片地址。
width	string	返回图片宽度。
height	string	返回图片高度。

返回示例

{
    "API_name": "ACG_API",
    "imgurl": "https:/api.hn/acg/13.jpg",
    "width": "3369",
    "height": "2146"
}

GET 请求方式

Bing每日一图调用

https://api.hn/bing.php

请求参数

参数名	必填	类型	说明
rand	否	string	是否随机调用
day	否	string	调用过去七天的图片 1-7
info	否	string	获取图片信息

GET 请求方式

QQ 头像调用

https://api.hn/qq.php?qq=2410768152

请求参数

参数名	必填	类型	说明
qq	是	string	指定需要获取头像的 QQ 号码。

返回格式

参数名	类型	说明
imgurl	string	返回 QQ 头像的图片地址。

返回示例

{
    "imgurl": "https://q.qlogo.cn/headimg_dl?dst_uin=2410768152&spec=100"
}

GET 请求方式

你的名字图片调用

https://api.hn/name.php?return=img

请求参数

参数名	必填	类型	说明
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro]，默认为 `url`。
json	否	string	返回一条标准 JSON 数据（图片地址）。
jsonpro	否	string	返回十条标准 JSON 数据（图片地址）。
url	否	string	直接返回一条图片链接。
urlpro	否	string	直接返回十条图片链接。
img	否	string	直接显示图片，不返回图片链接。

返回参数

参数名	类型	说明
API_name	string	API 名称。
imgurl	string	返回图片地址。
width	string	返回图片宽度。
height	string	返回图片高度。

返回示例

{
    "API_name": "nameapi",
    "imgurl": "https://api.hn/name/18.gif",
    "width": "400",
    "height": "300"
}

GET 请求方式

MC酱图片调用

https://api.hn/mc.php?return=img

请求参数

参数名	必填	类型	说明
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro]，默认为 `url`。
json	否	string	返回一条标准 JSON 数据（图片地址）。
jsonpro	否	string	返回十条标准 JSON 数据（图片地址）。
url	否	string	直接返回一条图片链接。
urlpro	否	string	直接返回十条图片链接。
img	否	string	直接显示图片，不返回图片链接。

返回参数

参数名	类型	说明
API_name	string	API 名称。
imgurl	string	返回图片地址。
width	string	返回图片宽度。
height	string	返回图片高度。

返回示例

{
    "API_name": "MC_API",
    "imgurl": "https://api.hn/mc/18.png",
    "width": "400",
    "height": "300"
}

GET 请求方式

JK小清新风格图片调用

https://api.hn/jk.php?zd=pc&return=img

请求参数

参数名	必填	类型	说明
zd	否	string	设备类型 [mobile\|pc\|zsy]，默认为 `zsy`，自动适配设备。
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro]，默认为 `img`。

返回参数

参数名	类型	说明
API_name	string	API 名称。
imgurl	string	图片地址。
width	string	图片宽度。
height	string	图片高度。

返回示例

{
    "API_name": "JK_API",
    "imgurl": "https://api.hn/jk/13.jpg",
    "width": "3369",
    "height": "2146"
}

GET 请求方式

元气壁纸调用

https://api.hn/yq.php?fl=dm

请求参数

参数名	必填	类型	说明
fl	否	string	分类 [dm\|fj\|mn]：动漫、风景、妹子
return	否	string	返回状态类型 [json\|img\|url]，默认为 `img`。

返回参数

参数名	类型	说明
image_url	string	返回图片地址（当 `return` 为 `json` 时）。

返回示例

{
    "image_url": "https://img-baofun.zhhainiao.com/pcwallpaper_ugc/static/c29ebe36efa9ecbf1ea5fb3a2d92b1aa.jpg"
}

GET 请求方式

随机懒加载图片调用

https://api.hn/loading.php?return=img

请求参数

参数名	必填	类型	说明
return	否	string	返回状态类型 [json\|jsonpro\|url\|urlpro\|img\|imgpro]，默认为 `url`。
json	否	string	返回一条标准 JSON 数据（图片地址）
jsonpro	否	string	返回十条标准 JSON 数据（图片地址）
url	否	string	直接返回一条图片链接
urlpro	否	string	直接返回十条图片链接
img	否	string	直接显示图片，不返回图片链接

返回参数

参数名	类型	说明
API_name	string	API 名称
imgurl	string	返回图片地址
width	string	返回图片宽度
height	string	返回图片高度

返回示例

{
    "API_name": "Loading_API",
    "imgurl": "https:\/\/api.hn\/loading\/18.gif",
    "width": "400",
    "height": "300"
}

工具API

除了图片服务，图汇API还提供多种实用的工具接口，帮助开发者快速实现常用功能：

网站图标获取（支持ICO、Base64格式）
IP地址签名档生成
ICP备案信息查询

快速响应

平均响应时间 < 100ms

安全可靠

数据加密传输

简单集成

标准RESTful接口

使用建议

建议添加适当的请求缓存
遵循API调用频率限制
及时处理错误响应

GET 请求方式

ICP 备案查询

https://api.hn/icp.php?domain=baidu.com

请求参数

参数名	必填	类型	说明
domain	是	string	要查询的域名

返回参数

参数名	类型	说明
code	int	返回状态，0表示成功，其他表示失败
msg	string	失败原因（如果有）
Domain	string	查询的域名
DomainIcpNum	string	备案号
CompanyName	string	主办单位名称
CompanyType	string	主办单位性质
AuditTime	string	备案审核日期
InTencent	string	是否接入腾讯云，true为是

返回示例

{
  "code": 0,
  "data": {
    "Domain": "baidu.com",
    "CompanyName": "北京百度网讯科技有限公司",
    "CompanyType": "企业",
    "DomainIcpNum": "京ICP证030173号-1",
    "AuditTime": "2019-05-16",
    "InTencent": false
  }
}

GET 请求方式

ICO图标调用

https://api.hn/ico.php?url=https://api.hn

请求参数

参数名	必填	类型	说明
url	是	string	获取网站的URL
type	否	string	指定返回的图标类型，传入 `1` 获取 base64 格式的图标

返回参数

参数名	类型	说明
imgurl	string	返回ICO图标的URL或base64编码数据（根据请求的 `type` 参数决定）

返回示例

{
    "imgurl": "https:\/\/api.hn\/ico\/favicon.ico"
}

GET 请求方式

IP签名档

https://api.hn/ip.php?domain=API.HN&diy=IP签名档

请求参数

参数名	必填	类型	说明
domain	否	string	生成的域名，显示在左边
diy	否	string	生成的名称，显示在右边居中

返回参数

参数名	类型	说明
imgurl	string	返回生成的IP签名档图片地址

返回示例

{
    "imgurl": "https:\/\/api.hn\/ip\/signature_image.png"
}