API

pixiv.yuki.sh 提供 Pixiv 作品信息查询、随机推荐与图片代理服务。通过作品 ID 可查询作品详情或直接获取原图，也可反向代理已有的 i.pximg.net 图片地址。

调用说明

作品查询和随机推荐接口无需 API Key。插画原图可通过 https://pixiv.yuki.sh/{id} 直接访问，多图作品在 ID 后附加页码即可，例如 https://pixiv.yuki.sh/120904374-2。

https://pixiv.yuki.sh/image/{path} 会为 i.pximg.net 图片进行反向代理。yuki.sh 域名下的页面可直接加载图片，其他来源需提供 API Key。

受保护接口统一使用 Bearer 鉴权。内部凭证 API_TOKEN 可调用所有受保护接口。申请获得的 API Key 仅可调用图片反向代理。

JSON 响应包含 success 和 message，请求成功时同时返回 data。

GET

/api/illust?id={id}

根据 Pixiv 作品 ID 返回标题、简介、画师、标签、尺寸及各规格图片地址。若数据库中不存在该作品，则实时查询 Pixiv。

将 {id} 替换为 Pixiv 作品页面地址末尾的数字 ID。

GET

/api/recommend?type=json&size=original&proxy=i.pixiv.re

从已收录且可用的作品中随机选择一项。设置 type=json 时返回作品数据。省略 type 时返回 302，并重定向至指定尺寸的图片。

size 可选值为 mini、thumb、small、regular 和 original。proxy 用于指定其他图片反向代理域名，例如 i.pixiv.re。

GET

/{id} 或 /{id}-{page}

返回指定作品的原图。多图作品可在 ID 后附加从 1 开始的页码。

例如 /120904374-2 表示作品 120904374 的第 2 张图片。

GET

/image/{path}

Pixiv 图片服务器 i.pximg.net 的反向代理。yuki.sh 同站请求可直接访问，其他来源必须提供 API Key。

将 {path} 替换为 i.pximg.net 域名后的完整路径。

不对外公开

仅供站点维护与定时任务使用，调用时须提供 API_TOKEN。

POST

/api/illust

接收请求体中的作品 ID，从 Pixiv 获取数据并写入数据库。

GET

/api/illust/sync?limit={limit}

根据 limit 指定的数量，优先同步最久未更新的作品。

POST

/api/key

根据邮箱和备注创建 API Key，每个邮箱只能创建一个。

请求失败时返回对应的 HTTP 状态码，并通过响应正文中的 message 字段说明原因。