随机图片APIRandom Picture API
Contents
本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=moe
每日自动更新中
二次元头像
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,效率最高。
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
- 描述:随机提取xx类别中包含R18内容在内的图片
- 示例:https://api.yimian.xyz/img/?type=koino&R18=true
5 报错格式
5.1 找不到指定type类型
若找不到指定的type类型,将会自动返回一个moe类型的图片。
5.2 找不到符合条件的图片
返回JSON
1 | { |
每台设备每天全局调用上限500次!!
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.
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: Randomly extract pictures containing R18 content 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
1 | { |
The maximum number of global calls for each device is 500 per day!!