随机图片APIRandom Picture API

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

This API is based on Huawei Cloud Object Storage and uses Huawei CDN Cloud acceleration. The global average download speed is 10MB/s. The API has included 1100+ two-dimensional pictures, 20+ Bing wallpapers (automatically captured daily), 150+ two-dimensional avatars, and 10+ pictures uploaded on the bed.

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

1 API地址

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

2 快速入门

随机二次元图片

• GET/POST /img?type=moe
• 示例：https://api.yimian.xyz/img?type=moe

随机Bing壁纸

• GET/POST /img?type=wallpaper
• 示例：https://api.yimian.xyz/img?type=wallpaper

随机二次元头像

• GET/POST /img?type=head
• 示例：https://api.yimian.xyz/img?type=head

随机图床图片

• GET/POST /img?type=imgbed
• 示例：https://api.yimian.xyz/img?type=imgbed

随机1920x1080尺寸二次元图片

• GET/POST /img?type=moe&size=1920x1080
• 示例：https://api.yimian.xyz/img?type=moe&size=1920x1080

3 参数列表

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

4 参数详解

4.1 type

二次元(默认)

• GET/POST /img?type=moe
• 图片来源: 呓喵酱的日常收藏(Pivix, Twitter)
• 示例：https://api.yimian.xyz/img?type=moe

bing每日壁纸

• GET/POST /img?type=wallpaper
• 图片来源: Bing每日壁纸
• 示例：https://api.yimian.xyz/img?type=wallpaper

  每日自动更新中

二次元头像

• GET/POST /img?type=head
• 图片来源: 从二次元图片中选择性截取
• 示例：https://api.yimian.xyz/img?type=head

呓喵酱图床

• GET/POST /img?type=imgbed
• 图片来源: 呓喵酱图床
• 示例：https://api.yimian.xyz/img?type=imgbed

こいぬちゃん

• GET/POST /img?type=koino
• 图片来源: @九条だんぼ(Twitter, Pivix, Google)
• 示例：https://api.yimian.xyz/img?type=koino

EasyVer人机验证

• GET/POST /img?type=easyver
• 图片来源: 呓喵酱优化整理
• 示例：https://api.yimian.xyz/img?type=easyver

4.2 display

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

false(默认)

• GET/POST /img?display=false
• 描述: 302跳转返回图片，建议使用
• 示例：https://api.yimian.xyz/img?display=false

true

• GET/POST /img?display=true
• 描述: 直接返回图片，速度慢
• 示例：https://api.yimian.xyz/img?display=true

4.3 size

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

??x??

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

??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??

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

??x??-??

• GET/POST /img?size=??x??-??
• 描述: 宽度x高度范围
• 示例：https://api.yimian.xyz/img?size=1920x1070-1090

??-??x??-??

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

??-??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参数

• GET/POST /img?size=??x??&range=100
• 描述: 宽度±100 x 高度±100
• 示例：https://api.yimian.xyz/img?size=1920x1080&range=100

对于??-??型size参数

• GET/POST /img?size=??-??x??-??&range=100
• 描述: 最小宽度-100|最大宽度+100 x 最小高度-100|最大高度+100
• 示例：https://api.yimian.xyz/img?size=1910-1930x1070-1090&range=100

对于*型size参数

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

4.5 id

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

二次元

• GET/POST /img?type=moe&id=15
• 描述：提取id为15的二次元图片
• 示例：https://api.yimian.xyz/img?type=moe&id=15

bing每日壁纸

• GET/POST /img?type=wallpaper&id=2019-07-28
• 描述：提取2019-07-28的壁纸图片
• 示例：https://api.yimian.xyz/img?type=wallpaper&id=2019-07-28

二次元头像

• GET/POST /img?type=head&id=15
• 描述：提取id为15的头像
• 示例：https://api.yimian.xyz/img?type=head&id=15

呓喵酱图床

• GET/POST /img?type=imgbed&id=529745e0
• 描述：提取id为529745e0的图床图片
• 示例：https://api.yimian.xyz/img?type=imgbed&id=529745e0

4.6 path

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

请前往呓喵酱の图库获取图片的path!

• GET/POST /img?path=xx/xx.xx
• 路径格式：种类/图片文件名
• 路径格式示例：imgbed/img_529745e0_900x900_8_null_normal.jpeg
• 描述：提取在xx/xx.xx的图片
• 示例：https://api.yimian.xyz/img/?path=imgbed/img_529745e0_900x900_8_null_normal.jpeg

4.7 R18

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

• GET/POST /img?type=xx&R18=true
  • 描述：是否解除对R18的限制，随机提取xx类别中包含R18图片在内的所有图片
  • 示例：https://api.yimian.xyz/img/?type=koino&R18=true

5 报错格式

5.1 找不到指定type类型

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

5.2 找不到符合条件的图片

返回JSON

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

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

---

CHANGELOG:

• 2021-1-23: 修改R18参数说明，在path方法中添加图库链接

This API does not promise permanent maintenance, please be sure to consider use risks before use! !

1 API address

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

2 Quick start

Random two-dimensional picture

• GET/POST /img?type=moe
• Example: https://api.yimian.xyz/img?type=moe

Random Bing Wallpaper

• GET/POST /img?type=wallpaper
• Example: https://api.yimian.xyz/img?type=wallpaper

Random two-dimensional avatar

• GET/POST /img?type=head
• Example: https://api.yimian.xyz/img?type=head

Random bed pictures

• GET/POST /img?type=imgbed
• Example: https://api.yimian.xyz/img?type=imgbed

Random 1920x1080 size two-dimensional picture

• GET/POST /img?type=moe&size=1920x1080
• Example: https://api.yimian.xyz/img?type=moe&size=1920x1080

3 Parameter list

Name	Description	Format	Example
type	Image type	moe/wallpaper/head/imgbed	type=moe
size	Filter by image size	??x??; *x??; *x*; ??-??x??; ??-??x??-??; ??-??x*	display=1920x1080; display=1920x*; display=1920-1950x230-500; display=1920-1950x*;
range	Size error range	number	range=100
id	Filter by image id	number	id=15
path	Extract pictures based on path	abs path	path=wallpaper/img_··mal.jpg
display	Whether to display in web page format	true/false(default)	display=true
R18	Whether to display 18 prohibited pictures	true/false(default)	R18=true

4 Detailed parameters

4.1 type

Two-dimensional (default)

• GET/POST /img?type=moe
• Image source: Daily Collection of Miao Miao Jiang (Pivix, Twitter)
• Example: https://api.yimian.xyz/img?type=moe

bing daily wallpaper

• GET/POST /img?type=wallpaper
• Image source: Bing Daily Wallpaper
• Example: https://api.yimian.xyz/img?type=moe

  Automatically updated daily

Two-dimensional avatar

• GET/POST /img?type=head
• Image source: Selectively intercepted from two-dimensional images
• Example: https://api.yimian.xyz/img?type=head

Miao meow sauce picture bed

• GET/POST /img?type=imgbed
• Image source: 呓喵酱图床
• Example: https://api.yimian.xyz/img?type=imgbed

こいぬちゃん

• GET/POST /img?type=koino
• Image source: @九条だんぼ (Twitter, Pivix, Google)
• Example: https://api.yimian.xyz/img?type=koino

EasyVer man-machine verification

• GET/POST /img?type=easyver
• Image source: Optimized finishing
• Example: https://api.yimian.xyz/img?type=easyver

4.2 display

If this parameter is set to true, 302 jump will be disabled and the complete picture encoding will be returned directly. This method is very low and slow. Please use it carefully.

false (default)

• GET/POST /img?display=false
• Description: 302 Jump to return to the picture, recommended
• Example: https://api.yimian.xyz/img?display=false

true

• GET/POST /img?display=true
• Description: Return to the picture directly, slow
• Example: https://api.yimian.xyz/img?display=true

4.3 size

Use this parameter to limit the image size. This parameter supports the following formats:

??x??

• GET/POST /img?size=??x??
• Description: width x height
• Example: https://api.yimian.xyz/img?size=1920x1080

??x*

• GET/POST /img?size=??x*
• Description: width x any height
• Example: https://api.yimian.xyz/img?size=1920x*

\x??*

• GET/POST /img?size=*x??
• Description: Any width x height
• Example: https://api.yimian.xyz/img?size=*x1080

\x**

• GET/POST /img?size=*x*
• Description: any width x any height (default)
• Example: https://api.yimian.xyz/img?size=*x *

??-??x??

• GET/POST /img?size=??-??x??
• Description: width range x height
• Example: https://api.yimian.xyz/img?size=1910-1930x1080

??x??-??

• GET/POST /img?size=??x??-??
• Description: width x height range
• Example: https://api.yimian.xyz/img?size=1920x1070-1090

??-??x??-??

• GET/POST /img?size=??-??x??-??
• Description: width range x height range
• Example: https://api.yimian.xyz/img?size=1910-1930x1070-1090

??-??x*

• GET/POST /img?size=??-??x*
• Description: width range x any height
• Example: https://api.yimian.xyz/img?size=1910 -1930x*

\x??-??*

• GET/POST /img?size=*x??-??
• Description: Any width x height range
• Example: https://api.yimian.xyz/img?size=* x1070-1090

4.4 range

This parameter specifies the allowable size error, which needs to be used with size, and the default is 0.

For the?? type size parameter

• GET/POST /img?size=??x??&range=100
• Description: width ±100 x height ±100
• Example: https://api.yimian.xyz/img?size=1920x1080&range=100

For??-?? type size parameter

• GET/POST /img?size=??-??x??-??&range=100
• Description: Min width-100|Max width+100 x Min height-100|Max height+100
• Example: https://api.yimian.xyz/img?size=1910-1930x1070-1090&range=100

For *type size parameter

• GET/POST /img?size=*x*&range=100
• Description: Invalid range

4.5 id

Each category has its own id system, and different image ids under the same category are unique.

*Two-dimensional *

• GET/POST /img?type=moe&id=15
• Description: Extract the two-dimensional image with id 15
• Example: https://api.yimian.xyz/img?type=moe&id=15

bing daily wallpaper

• GET/POST /img?type=wallpaper&id=2019-07-28
• Description: Extract wallpaper pictures from 2019-07-28
• Example: https://api.yimian.xyz/img?type=wallpaper&id=2019-07-28

Two-dimensional avatar

• GET/POST /img?type=head&id=15
• Description: Extract the avatar with id 15
• Example: https://api.yimian.xyz/img?type=head&id=15

Miao meow sauce picture bed

• GET/POST /img?type=imgbed&id=529745e0
• Description: Extract the picture bed with id 529745e0
• Example: https://api.yimian.xyz/img?type=imgbed&id=529745e0

4.6 path

Use absolute path to directly extract pictures, priority is higher than type, highest efficiency.

Please go to 呓喵酱の Gallery to get the path of the picture!

• GET/POST /img?path=xx/xx.xx
• Path format: Type/Picture File Name
• Example of path format: imgbed/img_529745e0_900x900_8_null_normal.jpeg
• Description: Extract pictures in xx/xx.xx
• Example: https://api.yimian.xyz/img/?path=imgbed/img_529745e0_900x900_8_null_normal.jpeg

4.7 R18

Whether to display 18 prohibited pictures, the default is false.

• GET/POST /img?type=xx&R18=true
  • Description: Whether to lift the restriction on R18, randomly extract all pictures including R18 pictures in xx category
  • Example: https://api.yimian.xyz/img/?type=koino&R18=true

5 Error format

5.1 Cannot find the specified type

If the specified type cannot be found, a moe type picture will be automatically returned.

5.2 Can’t find matching images

Return JSON

{
  "err": "error message"
}

The maximum number of global calls for each device is 500 per day!!