老婆图片库

图片API文档

概述

本文档详细说明了图片API的使用方法和参数说明。该API提供了图片数据的检索和访问功能，支持多种筛选条件和返回格式。

基础信息

• API端点: https://api.sb6.me/image
• 请求方式: GET
• 响应格式: JSON或302重定向

请求参数

参数详细说明

type

• json: 返回JSON格式的图片数据
• 302: 直接重定向到随机选择的图片URL

image

• all: 所有类型的图片（默认值）
• vertical: 仅竖图
• horizontal: 仅横图
• square: 仅方图

search

用于按来源(source)或角色名(character)筛选图片，支持多个关键词（用空格分隔）

响应格式

JSON响应 (type=json)

当请求成功时，API返回以下格式的JSON数据：

单个图片对象：

{"url":"图片URL","small_url":"缩略图URL","source":"来源说明","character":"角色名称","width":图片宽度,"height":图片高度}

或多个图片对象的数组：

[{"url":"图片URL1","small_url":"缩略图URL1","source":"来源说明1","character":"角色名称1","width":图片宽度1,"height":图片高度1},{"url":"图片URL2","small_url":"缩略图URL2","source":"来源说明2","character":"角色名称2","width":图片宽度2,"height":图片高度2}]

错误响应

当发生错误时，API返回以下格式的JSON：

{"error":"错误描述"}

302重定向 (type=302)

当type参数为302时，API会直接返回302状态码并重定向到随机选择的图片URL。

使用示例

示例1：获取所有图片的随机一条JSON数据

https://api.sb6.me/image?type=json&image=all

示例2：搜索特定角色的图片

https://api.sb6.me/image?type=json&search=初音未来

示例3：直接重定向到随机竖图

https://api.sb6.me/image?type=302&image=vertical

示例4：错误响应

https://api.sb6.me/image?type=invalid

注意事项

1. API使用HTTPS协议，确保数据传输安全
2. 所有图片URL应使用HTTPS协议以确保安全加载
3. 当没有匹配的图片时，API返回404状态码和错误信息
4. 搜索功能不区分大小写，支持部分匹配
5. 建议在前端使用small_url字段显示缩略图以提高页面加载性能

错误代码