本API基于华为云对象存储,使用华为CDN云加速,全球平均下载速度达10MB/s。API中已收录1100+张二次元图片,20+张Bing壁纸(每日自动抓取),150+张二次元头像,10+张图床上传图片。

本API不承诺永久维护,使用前请务必斟酌使用风险!!

1 API地址

  • https://api.yimian.xyz/img

2 快速入门

随机二次元图片

随机Bing壁纸

随机二次元头像

随机图床图片

随机1920x1080尺寸二次元图片

3 参数列表

名称描述格式示例
type图片种类moe/wallpaper/head/imgbedtype=moe
size根据图片大小筛选??x??;
*x??;
*x*;
??-??x??;
??-??x??-??;
??-??x*
display=1920x1080;
display=1920x*;
display=1920-1950x230-500;
display=1920-1950x*;
range尺寸误差范围numberrange=100
id根据图片id筛选numberid=15
path根据路径提取图片abs pathpath=wallpaper/img_··mal.jpg
display是否以网页格式展示true/false(default)display=true
R18是否显示18禁图片true/false(default)R18=true

4 参数详解

4.1 type

二次元(默认)

bing每日壁纸

二次元头像

呓喵酱图床

こいぬちゃん

EasyVer人机验证

4.2 display

如果本参数置为true,则会禁用302跳转,直接返回完整图片编码。本方法效率极低,速度很慢,请慎用。

false(默认)

true

4.3 size

使用本参数限制图片尺寸。本参数支持以下格式:

??x??

??x*

  • GET/POST /img?size=??x*
  • 描述: 宽度x任意高度
  • 示例:https://api.yimian.xyz/img?size=1920x*
  • *x??

    • GET/POST /img?size=*x??
    • 描述: 任意宽度x高度
  • 示例:https://api.yimian.xyz/img?size=*x1080
  • *x*

    • GET/POST /img?size=*x*
    • 描述: 任意宽度x任意高度(默认)
  • 示例:https://api.yimian.xyz/img?size=*x*
  • ??-??x??

    ??x??-??

    ??-??x??-??

    ??-??x*

    • GET/POST /img?size=??-??x*
    • 描述: 宽度范围x任意高度
  • 示例:https://api.yimian.xyz/img?size=1910-1930x*
  • *x??-??

    • GET/POST /img?size=*x??-??
    • 描述: 任意宽度x高度范围
  • 示例:https://api.yimian.xyz/img?size=*x1070-1090
  • 4.4 range

    本参数规定允许的size的误差,需搭配size使用,默认为0。

    对于??型size参数

    对于??-??型size参数

    对于*型size参数

    • GET/POST /img?size=*x*&range=100
    • 描述: range无效

    4.5 id

    每一个种类都有自己的id系统,同一种类下不同图片id唯一。

    二次元

    bing每日壁纸

    二次元头像

    呓喵酱图床

    4.6 path

    使用绝对路径直接提取图片,优先级高于type,效率最高

    4.7 R18

    是否显示18禁图片,默认为false。

    5 报错格式

    5.1 找不到指定type类型

    若找不到指定的type类型,将会自动返回一个moe类型的图片。

    5.2 找不到符合条件的图片

    返回JSON

    {
      "err": "错误信息"
    }

    每台设备每天全局调用上限500次!!

    Last modification:December 1st, 2019 at 12:13 pm
    If you think my article is useful to you, please feel free to appreciate