iotcat
/
EEE.DOG-blog
mirror of https://github.com/IoTcat/EEE.DOG-blog.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
15 Commits
3 Branches
0 Tags
1010 KiB
 
 
Tag: Branch: Tree: 6ca581ba37
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '6ca581ba37'
${ noResults }
EEE.DOG-blog/source/_posts/rand-pic-api.md

495 lines
18 KiB
Raw Blame History

---
title: 随机图片API
titleEN: Random Picture API
date: 2019-07-10
display: true
categories:
- tech
tags:
- api
- img
- random
- moe
---
{% raw %}<span class=".zh">{% endraw %}
本API基于华为云对象存储，使用华为CDN云加速，全球平均下载速度达10MB/s。API中已收录1100+张二次元图片，20+张Bing壁纸(每日自动抓取)，150+张二次元头像，10+张图床上传图片。
{% raw %}</span>{% endraw %}
{% raw %}<span class=".en">{% endraw %}
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.
{% raw %}</span>{% endraw %}
<!--more-->
{% raw %}
<script>
session.onload(function(){
if(page.tran.getLang() == 'en'){
tips.warning({
title: 'Caution',
position: 'topRight',
message: 'This page was translated by Machine!!',
buttons: [['<button>Show Original Page</button>', function (instance, toast) {
page.tran.setLang('zh');
instance.hide({ transitionOut: 'fadeOut' }, toast, 'button');
}, true]]
});
}
});
</script>
{% endraw %}
{% raw %}<span class=".zh">{% endraw %}
> 本API不承诺**永久**维护，使用前请务必斟酌**使用风险**！！
## 1 API地址
- `https://api.yimian.xyz/img`
## 2 快速入门
***随机二次元图片***
- `GET/POST /img?type=moe`
- 示例：[https://api.yimian.xyz/img?type=moe](https://api.yimian.xyz/img?type=moe)
***随机Bing壁纸***
- `GET/POST /img?type=wallpaper`
- 示例：[https://api.yimian.xyz/img?type=wallpaper](https://api.yimian.xyz/img?type=wallpaper)
***随机二次元头像***
- `GET/POST /img?type=head`
- 示例：[https://api.yimian.xyz/img?type=head](https://api.yimian.xyz/img?type=head)
***随机图床图片***
- `GET/POST /img?type=imgbed`
- 示例：[https://api.yimian.xyz/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](https://api.yimian.xyz/img?type=moe&size=1920x1080)
## 3 参数列表
名称 | 描述 | 格式 | 示例
:---:| :---: | :---: | :---:
**type** | 图片种类 | `moe`/`wallpaper`/`head`/`imgbed` | `type=moe`
**size** | 根据图片大小筛选 | `??x??`;<br>`*x??`;<br>`*x*`;<br>`??-??x??`;<br>`??-??x??-??`;<br>`??-??x*` | `display=1920x1080`;<br>`display=1920x*`;<br>`display=1920-1950x230-500`;<br>`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](https://api.yimian.xyz/img?type=moe)
***bing每日壁纸***
- `GET/POST /img?type=wallpaper`
- 图片来源: Bing每日壁纸
- 示例：[https://api.yimian.xyz/img?type=moe](https://api.yimian.xyz/img?type=wallpaper)
> 每日自动更新中
***二次元头像***
- `GET/POST /img?type=head`
- 图片来源: 从二次元图片中选择性截取
- 示例：[https://api.yimian.xyz/img?type=head](https://api.yimian.xyz/img?type=head)
***呓喵酱图床***
- `GET/POST /img?type=imgbed`
- 图片来源: [呓喵酱图床](https://imgbed.yimian.xyz)
- 示例：[https://api.yimian.xyz/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](https://api.yimian.xyz/img?type=koino)
***EasyVer人机验证***
- `GET/POST /img?type=easyver`
- 图片来源: 呓喵酱优化整理
- 示例：[https://api.yimian.xyz/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](https://api.yimian.xyz/img?display=false)
**true**
- `GET/POST /img?display=true`
- 描述: 直接返回图片，速度慢
- 示例：[https://api.yimian.xyz/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](https://api.yimian.xyz/img?size=1920x1080)
***??x\****
- `GET/POST /img?size=??x*`
- 描述: 宽度x任意高度
{% raw %}
<li>示例：<a href="https://api.yimian.xyz/img?size=1920x*" target="_blank">https://api.yimian.xyz/img?size=1920x*</a></li>
{% endraw %}
***\*x??***
- `GET/POST /img?size=*x??`
- 描述: 任意宽度x高度
{% raw %}
<li>示例：<a href="https://api.yimian.xyz/img?size=*x1080" target="_blank">https://api.yimian.xyz/img?size=*x1080</a></li>
{% endraw %}
***\*x\****
- `GET/POST /img?size=*x*`
- 描述: 任意宽度x任意高度(默认)
{% raw %}
<li>示例：<a href="https://api.yimian.xyz/img?size=*x*" target="_blank">https://api.yimian.xyz/img?size=*x*</a></li>
{% endraw %}
***??-??x??***
- `GET/POST /img?size=??-??x??`
- 描述: 宽度范围x高度
- 示例：[https://api.yimian.xyz/img?size=1910-1930x1080](https://api.yimian.xyz/img?size=1910-1930x1080)
***??x??-??***
- `GET/POST /img?size=??x??-??`
- 描述: 宽度x高度范围
- 示例：[https://api.yimian.xyz/img?size=1920x1070-1090](https://api.yimian.xyz/img?size=1920x1070-1090)
***??-??x??-??***
- `GET/POST /img?size=??-??x??-??`
- 描述: 宽度范围x高度范围
- 示例：[https://api.yimian.xyz/img?size=1910-1930x1070-1090](https://api.yimian.xyz/img?size=1910-1930x1070-1090)
***??-??x\****
- `GET/POST /img?size=??-??x*`
- 描述: 宽度范围x任意高度
{% raw %}
<li>示例：<a href="https://api.yimian.xyz/img?size=1910-1930x*" target="_blank">https://api.yimian.xyz/img?size=1910-1930x*</a></li>
{% endraw %}
***\*x??-??***
- `GET/POST /img?size=*x??-??`
- 描述: 任意宽度x高度范围
{% raw %}
<li>示例：<a href="https://api.yimian.xyz/img?size=*x1070-1090" target="_blank">https://api.yimian.xyz/img?size=*x1070-1090</a></li>
{% endraw %}
### 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](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](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](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](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](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](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](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](https://api.yimian.xyz/img/?type=koino&R18=true)
## 5 报错格式
### 5.1 找不到指定type类型
若找不到指定的type类型，将会自动返回一个moe类型的图片。
### 5.2 找不到符合条件的图片
返回JSON
```js
{
"err": "错误信息"
}
```
> 每台设备每天**全局**调用上限500次!！
{% raw %}</span>{% endraw %}
{% raw %}<span class=".en">{% endraw %}
> 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](https://api.yimian.xyz/img?type=moe)
***Random Bing Wallpaper***
- `GET/POST /img?type=wallpaper`
- Example: [https://api.yimian.xyz/img?type=wallpaper](https://api.yimian.xyz/img?type=wallpaper)
***Random two-dimensional avatar***
- `GET/POST /img?type=head`
- Example: [https://api.yimian.xyz/img?type=head](https://api.yimian.xyz/img?type=head)
***Random bed pictures***
- `GET/POST /img?type=imgbed`
- Example: [https://api.yimian.xyz/img?type=imgbed](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](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??`;<br>`*x??`;<br>`*x*`;<br>`??-??x?? `;<br>`??-??x??-??`;<br> `??-??x*` | `display=1920x1080`;<br>`display=1920x*`;<br >`display=1920-1950x230-500`;<br>`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](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](https://api.yimian.xyz/img?type=wallpaper)
> 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](https://api.yimian.xyz/img?type=head)
***Miao meow sauce picture bed***
- `GET/POST /img?type=imgbed`
- Image source: [呓喵酱图床](https://imgbed.yimian.xyz)
- Example: [https://api.yimian.xyz/img?type=imgbed](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](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](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](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](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](https://api.yimian.xyz/img?size=1920x1080)
***??x\****
- `GET/POST /img?size=??x*`
- Description: width x any height
{% raw %}
<li>Example: <a href="https://api.yimian.xyz/img?size=1920x*" target="_blank">https://api.yimian.xyz/img?size=1920x*</a></li>
{% endraw %}
***\*x??***
- `GET/POST /img?size=*x??`
- Description: Any width x height
{% raw %}
<li>Example: <a href="https://api.yimian.xyz/img?size=*x1080" target="_blank">https://api.yimian.xyz/img?size=*x1080</a></li>
{% endraw %}
***\*x\****
- `GET/POST /img?size=*x*`
- Description: any width x any height (default)
{% raw %}
<li>Example: <a href="https://api.yimian.xyz/img?size=*x*" target="_blank">https://api.yimian.xyz/img?size=*x *</a></li>
{% endraw %}
***??-??x??***
- `GET/POST /img?size=??-??x??`
- Description: width range x height
- Example: [https://api.yimian.xyz/img?size=1910-1930x1080](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](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](https://api.yimian.xyz/img?size=1910-1930x1070-1090)
***??-??x\****
- `GET/POST /img?size=??-??x*`
- Description: width range x any height
{% raw %}
<li>Example: <a href="https://api.yimian.xyz/img?size=1910-1930x*" target="_blank">https://api.yimian.xyz/img?size=1910 -1930x*</a></li>
{% endraw %}
***\*x??-??***
- `GET/POST /img?size=*x??-??`
- Description: Any width x height range
{% raw %}
<li>Example: <a href="https://api.yimian.xyz/img?size=*x1070-1090" target="_blank">https://api.yimian.xyz/img?size=* x1070-1090</a></li>
{% endraw %}
### 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](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](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](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](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](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](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](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](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
```js
{
"err": "error message"
}
```
>The maximum number of **global calls** for each device is 500 per day!!
{% raw %}</span>{% endraw %}