图集 API 接口参考

1. 基础地址

https://cik.netlify.app

图集接口返回来源目录和图片路径列表。与视频接口不同，这些接口不使用 {code, data, msg} 业务响应包装。

2. 获取图集来源

GET https://cik.netlify.app/api/gallery

2.1 请求参数

无。

2.2 响应字段

响应是图集来源数组。

字段	类型	说明
url	string	获取该来源图片列表的 API 路径
name	string	来源名称
referer	string | null	图片主机可能要求的 Referer；null 表示接口未声明该要求

2.3 响应示例

[
  {
    "url": "/api/gallery/taotuhome",
    "name": "套图之家",
    "referer": null
  },
  {
    "url": "/api/gallery/yalayi",
    "name": "雅拉伊",
    "referer": "yalayi.net"
  }
]

2.4 当前来源

来源标识	名称	Referer
taotuhome	套图之家	无
yalayi	雅拉伊	yalayi.net
xiuaiss	秀丝网（有水印）	无
jablehk	JableHK	无
cosjiang	COS酱	无
mtcos	喵糖映画	mtcos.net
jpmn5	极品美女网	无
2meinv	爱美女	无

来源可能随服务更新而变化。调用方应优先使用 /api/gallery 的实时响应，不要只依赖上面的静态列表。

3. 获取图片列表

GET https://cik.netlify.app/api/gallery/{source}

3.1 路径参数

参数	类型	必填	说明
source	string	是	图集来源标识，取自来源接口 url 的最后一段

请求示例：

GET https://cik.netlify.app/api/gallery/taotuhome

3.2 响应字段

字段	类型	说明
prefix	string	图片地址公共前缀
data	string[]	图片相对路径列表

3.3 响应示例

{
  "prefix": "https://images.example.com/",
  "data": [
    "gallery/001.jpg",
    "gallery/002.jpg"
  ]
}

完整图片地址由 prefix 和列表项组合得到：

const response = await fetch("https://cik.netlify.app/api/gallery/taotuhome")
const { prefix, data } = await response.json()
const firstImageURL = new URL(data[0], prefix).href

4. 分页与数据量

当前图片列表接口没有发现分页参数，每次会返回该来源的完整路径数组。部分来源包含数万甚至十万条记录，响应体可能很大。

建议：

• 在自己的服务端请求并缓存结果，避免客户端反复下载完整列表。
• 客户端只渲染当前可见的少量图片，使用虚拟列表或懒加载。
• 不要假定路径永久有效；第三方图片可能被删除或更换域名。

5. Referer、跨域与混合内容

• /api/gallery 中 referer 非空的来源可能存在防盗链限制，直接使用图片 URL 不一定能显示。
• 浏览器 JavaScript 不能主动设置任意 Referer 请求头，需要通过自己控制的服务端代理处理。
• CIK 的 JSON 接口当前没有返回 Access-Control-Allow-Origin，其他域名页面通常不能直接通过浏览器 fetch 调用。
• 某些来源的图片前缀仍是 HTTP；HTTPS 页面加载时可能被浏览器作为混合内容拦截。
• <img> 能显示跨域图片不代表可以通过 Canvas、Fetch 或其他方式读取其内容。

6. 使用注意事项

• 接口聚合的是第三方图片来源，CIK 返回成功不代表每张图片都可访问。
• 来源内容可能包含成人内容，接入前应进行内容审核、年龄限制和访问控制。
• 使用第三方图片前，应自行确认版权、隐私和当地法律要求。
• 这些接口没有公开的版本和稳定性承诺，不应作为生产环境的唯一数据源。