# API V2

加入群组

加入我们的Telegram群组，获取API的最新信息 https://t.me/sex_photo_api (opens new window)

警告

V1 API已经过时，尽管他依然可以使用，但还是建议您尽快更新至V2 API。

滥用限制

请勿滥用此API，滥用行为包括但不限于短时间内大量请求API，违反您当地法律使用图片等等，目前已经采取IP封锁的方式限制滥用行为，如果滥用行为继续或升级，API也将会提升限制手段

[GET] /api/v2/ 获取色图
[GET] /api/v2/img 直接获取图片

# [GET] /api/v2/ 获取色图

说明

获取色图，支持按照条件筛选

https://sex.nyan.xyz/api/v2/

# 可用参数

超过最大数量

如果参数超过最大数量限制，则只会返回最大数量的结果

数组类型参数

数组类型参数可以通过追加同名参数的方式来发送，例如?tag=BlueArchive&tag=loli

参数	类型	解释	默认
r18	bool	是否获取R18图片	false
num	int	返回的结果数量，最少获取1张，最多获取10张	1
author_uuid	[]int	返回指定UID作者的图片，最多10个	nil
keyword	string	搜索关键字，支持搜索标题，作者名称，标签，支持模糊搜索	nil
tag	[]string	返回指定标签的作品，最多10个	nil

# 响应

{
  "success": true,
  "status": 2000,
  "message": "OK",
  "version": "2.0.0",
  "codename": "Koharu",
  "time": 1655805837,
  "data": [
    {
      "pid": 98699738,
      "page": "https://www.pixiv.net/artworks/98699738",
      "author": "ふけまち",
      "author_uid": 129822,
      "title": "水着アズサ",
      "width": 1505,
      "height": 2125,
      "file_ext": "png",
      "upload_date": 1653836411000,
      "tags": [
        "ブルーアーカイブ",
        "碧蓝档案",
        "白洲アズサ",
        "Shirasu Azusa",
        "水着",
        "泳装"
      ],
      "url": "https://sex.nyan.xyz/img-original/img/2022/05/30/00/00/11/98699738_p0.png"
    }
  ]
}

字段	类型	解释
success	bool	请求是否成功
status	int	响应状态码
message	string	响应信息
version	string	API版本号
codename	string	API代号
time	int	请求时间戳(毫秒)
data	[]data	返回数据

# data

字段	类型	解释
pid	int	图片ID
page	string	图片Pixiv页面
author	string	作者用户名
author_uid	int	作者UID
title	string	图片标题
width	int	图片宽度(px)
height	int	图片高度(px)
file_ext	string	图片格式
upload_date	int	图片上传时间戳(毫秒)
tags	[]string	图片标签
url	string	图片地址

# Status

可能返回的状态码

Status	解释
2000	请求成功
4000	请求参数类型不正确
4001	必要参数为空
4006	提交的信息存在错误
4030	请求被拦截
4290	请求速度超过阈值
5000	服务器内部错误

# [GET] /api/v2/img 直接获取图片

说明

直接返回图片，可用于嵌入页面

https://sex.nyan.xyz/api/v2/img