请求参数说明（/setu/v2）

所有参数均为 可选，不传则使用默认值。
/blog/setu 不需要传任何参数，它内部使用固定默认值。

---

参数总览

参数名	类型	默认值	描述
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.yukiryou.top	替换图片 URL 域名
dateAfter	long	无	上传时间 ≥ 此时间（毫秒时间戳）
dateBefore	long	无	上传时间 ≤ 此时间（毫秒时间戳）
dsc	bool	false	是否按时间倒序（新到旧）
excludeAI	bool	false	排除 AI 作品
aspectRatio	string	无	限制宽高比，如 1.6-1.8
pid	long	无	按 Pixiv 作品 ID 精确查询

---

尺寸（size）字段说明

支持的尺寸值：

• original
• regular
• small
• thumb
• mini

默认仅返回 original：

{
  "size": ["original"]
}

如果想同时获取多个尺寸：

GET /setu/v2?num=3&size=original&size=regular

或 POST：

{
  "num": 3,
  "size": ["original", "regular"]
}

---

proxy 字段说明

proxy 用于 替换图片 URL 的域名，方便统一走自己的图床或反代。

• 默认：i.yukiryou.top
• 如果你想使用原始地址，可以不传 proxy，或传空（取决于后端配置）

示例：

• 原始 URL：https://i.pximg.net/img-original/...
• 传入 proxy=i.yukiryou.top 后返回：https://i.yukiryou.top/img-original/...

---

标签匹配规则（tag）

tag 支持多种组合方式，常见用法：

1. 单个标签

?tag=猫耳

表示包含「猫耳」标签的作品。

2. 多个标签（AND）

?tag=猫耳&tag=白发

表示必须同时包含「猫耳」和「白发」。

---

关键字匹配（keyword）

keyword 对 标题 / 作者 / 标签 做模糊匹配：

?keyword=白丝

• 与 tag 组合时，通常会扩展匹配范围，可能增加查询耗时
• 匹配规则为 小写 + contains，不区分大小写

---

其他筛选字段说明

• uid：按作者 UID 精确过滤，可传多个 UID
• dateAfter / dateBefore：毫秒时间戳，可以用于只看最近的作品
• dsc：
  • true：按时间倒序（新 → 旧）
  • false / 未传：随机或默认排序
• aspectRatio：
  • 1.6-1.8：表示 1.6 ≤ 宽高比 ≤ 1.8
  • 1.777：表示接近 16:9 的比例（允许一定误差）
• excludeAI：
  • 为 true 时排除标记为 AI 的作品（aiType=2）

---

与 /blog/setu 的区别

• /setu/v2：

  • 需要携带 X-API-Key
  • 可以自由指定各种参数
  • 适用于后端服务 / Bot / 私有应用

• /blog/setu：

  • 不需要任何参数，也不需要 API Key
  • 固定：num=1、r18=0、size=["original"]
  • 仅供特定域名的前端页面直接调用