随机图片API文档

简单易用的随机图片API服务

API访问链接

基础API地址

/api/random

使用示例

重定向模式 (/api/random)

/api/random

直接响应模式 (/api/response)

/api/response

带参数 (r18=r18)

/api/random?r18=r18

直接响应带参数 (r18=r18)

/api/response?r18=r18

带参数 (sfw=sfw)

/api/random?sfw=sfw

直接响应带参数 (sfw=sfw)

/api/response?sfw=sfw

响应格式

成功响应

API直接返回图片文件，而不是JSON格式的响应。

状态码：200 OK
Content-Type：image/jpeg, image/png, image/webp 等
响应头：
  • X-Image-Id - 图片唯一标识
  • X-Image-Filename - 图片文件名
  • X-Response-Time - 响应时间
  • Cache-Control - 缓存控制

错误响应

400 Bad Request- 请求参数无效
403 Forbidden- API服务已禁用
404 Not Found- 没有找到符合条件的图片
429 Too Many Requests- 请求频率过高
500 Internal Server Error- 服务器内部错误

注意事项

!

频率限制： API有请求频率限制，请避免过于频繁的请求。

i

缓存： 图片响应包含缓存头，建议客户端适当缓存以提高性能。

✓

HTTPS： 建议使用HTTPS协议访问API以确保安全性。