起因#

一直以来总想根据自己的性趣去部署一个图片api，最近购置了阿里云服务器进行备案，就干脆把阿里云的服务器拿来搭建好了。

API v2#

https://api.yukiryou.icu/setu/v2

接口地址（GET / POST 通用）

1
/setu/v2

返回格式：JSON

请求参数说明#

参数名	数据类型	默认值	描述
`r18`	int	0	0 非 R18，1 R18，2 混合
`num`	int	1	返回数量，范围 1–20
`uid`	int[]	无	按作者 UID 过滤（最多 20 个）
`keyword`	string	无	标题 / 作者 / 标签模糊匹配
`tag`	string[]	无	标签 AND / OR 组合匹配
`size`	string[]	[“original”]	返回图片尺寸（可多选）
`proxy`	string	i.pixiv.re	替换图片 URL 域名
`dateAfter`	long	无	上传时间 ≥ 此时间（毫秒）
`dateBefore`	long	无	上传时间 ≤ 此时间（毫秒）
`dsc`	boolean	false	禁用自动缩写转换
`excludeAI`	boolean	false	排除 AI 作品（aiType = 2）
`aspectRatio`	string	无	图片宽高比过滤

标签（tag）高级匹配规则#

标签匹配支持 AND / OR 组合，大小写不敏感。

AND 规则（数组之间）#

例如：

1
tag=萝莉|少女
2

3
tag=黑丝|白丝

这代表：

1
(萝莉 OR 少女) AND (黑丝 OR 白丝)

OR 规则（同一个字符串内用 `|` 分隔）#

例如：

1
tag=巨乳|おっぱい

表示匹配其中任意一个即可。

匹配范围：#

| 字段 | 是否参与匹配 |

|------|-------------|

| 标签（tags） | ✔ |

| 标题（title） | ✔ |

| 作者（author） | ✔ |

全部以小写 + 包含（contains）匹配方式处理。

GET 示例#

1️⃣ 获取 1 个非 R18 的随机图（默认 original 尺寸）#

1
GET https://api.yukiryou.icu/setu/v2

2️⃣ 获取 5 张 original + regular 尺寸图片#

1
GET https://api.yukiryou.icu/setu/v2?num=5&size=original&size=regular

3️⃣ 标签高级匹配示例#

1
GET https://api.yukiryou.icu/setu/v2?tag=萝莉|少女&tag=白丝|黑丝

即：

1
(萝莉 OR 少女) AND (白丝 OR 黑丝)

4️⃣ 按关键字模糊搜索#

1
GET https://api.yukiryou.icu/setu/v2?keyword=碧蓝航线

5️⃣ 按作者 uid 搜索#

1
GET https://api.yukiryou.icu/setu/v2?uid=12345&uid=67890

6️⃣ 限制长宽比#

1
GET https://api.yukiryou.icu/setu/v2?aspectRatio=1.6-1.8

7️⃣ 过滤 AI 图#

1
GET https://api.yukiryou.icu/setu/v2?excludeAI=true

📨 POST 示例#

POST 支持 JSON 的二维 tag：

1
{
2

3
  "num": 5,
4

5
  "r18": 0,
6

7
  "tag": [
8

9
    ["萝莉", "少女"],
10

11
    ["黑丝", "白丝"]
12

13
  ],
14

15
  "size": ["original", "regular", "small"],
16

17
  "excludeAI": false
18

19
}

就是：

1
tag=萝莉|少女
2

3
tag=黑丝|白丝

返回格式#

示例：

1
{
2

3
  "error": "",
4

5
  "data": [
6

7
    {
8

9
      "pid": 82675630,
10

11
      "p": 0,
12

13
      "uid": 8244461,
14

15
      "title": "水着ル・マラン",
16

17
      "author": "Vldjm13",
18

19
      "r18": false,
20

21
      "width": 3360,
22

23
      "height": 3960,
24

25
      "tags": ["アズールレーン","碧蓝航线","水着"],
26

27
      "ext": "png",
28

29
      "aiType": 0,
30

31
      "uploadDate": 1593535904000,
32

33
      "urls": {
34

35
        "original": "https://i.yukiryou.top/img-original/...png",
36

37
        "regular": "https://i.yukiryou.top/img-master/..._master1200.jpg",
38

39
        "small": "/c/540x540_70/img-master/..._master1200.jpg",
40

41
        "thumb": "/c/250x250_80_a2/img-master/..._square1200.jpg",
42

43
        "mini": "/c/48x48/img-master/..._square1200.jpg"
44

45
      }
46

47
    }
48

49
  ]
50

51
}

🔄 图片 URL 自动生成逻辑#

你只需要 original，即：

1
/img-original/.../90551655_p0.jpg

API 会自动生成：

size	URL 规则
original	`/img-original/.../90551655_p0.jpg`
regular	`/img-master/.../p0_master1200.jpg`
small	`/c/540x540_70/img-master/..._master1200.jpg`
thumb	`/c/250x250_80_a2/img-master/..._square1200.jpg`
mini	`/c/48x48/img-master/..._square1200.jpg`

⚠️ 注意事项#

num 最大为 20
original 为唯一保证存在的尺寸
PNG 原图不一定有 regular/small/thumb/mini
标签大小写不敏感
tag 与 keyword 组合可能降低性能

其他服务#

QQ Bot

后续可能优化一下并公开插件

起因#