UapiProUApiPro
随机

随机图片

0次调用
免费接口

需要一张随机图片作为占位符或者背景吗？这个接口是你的不二之选。

功能概述

这是一个非常简单的接口，它会从我们庞大的图库和精选外部图床中随机挑选一张图片，然后通过 302 重定向让你直接访问到它。这使得它可以非常方便地直接用在 HTML 的 <img> 标签中。

你可以通过 /api/v1/random/image?category=acg&type=4k 这样的请求获取由UapiPro服务器提供的图片，也可以通过 /api/v1/random/image?category=ai_drawing 获取由外部图床精选的图片。

如果你不提供任何 category 参数，程序会从所有图片（包括本地的和URL的）中随机抽取一张（全局随机图片不包含ikun和AI绘画）。

如果你需要更精确地控制图片类型，请使用/image/random/{category}/{type} 接口。

支持的主类别与子类别

  • acg（二次元动漫）
    • pc
    • mb
  • 外部图床精选/混合动漫
    • landscape: 风景图。
    • anime: 混合了UapiPro服务器的acg和外部图床的general_anime分类下的图片。
    • pc_wallpaper: 电脑壁纸。
    • mobile_wallpaper: 手机壁纸。
    • general_anime: 动漫图。
    • ai_drawing: AI绘画。
  • 其他分类
    • bq（表情包/趣图）
      • eciyuan
      • ikun
      • xiongmao
      • waiguoren
      • maomao
    • furry（福瑞）
      • z4k
      • szs8k
      • s4k
      • 4k

默认全局随机（未指定category参数）时，不会包含ikun和AI绘画（ai_drawing）类别的图片。

查询参数

category
string可选

（可选）指定图片主类别。

支持的主类别：

  • acg（二次元动漫，UapiPro服务器）
  • landscape（风景图，外部图床）
  • anime（混合动漫）
  • pc_wallpaper（电脑壁纸，外部图床）
  • mobile_wallpaper（手机壁纸，外部图床）
  • general_anime（动漫图，外部图床）
  • ai_drawing（AI绘画，外部图床）
  • bq（表情包/趣图，UapiPro服务器）
  • furry（福瑞，UapiPro服务器）

如果不指定，将从所有图片中随机抽取（不包含ikun 和 ai_drawing）。

type
string可选

（可选，仅UapiPro服务器图片支持）指定图片子类别。

  • bq: xiongmao, waiguoren, maomao, ikun, eciyuan
  • acg: pc, mb
  • furry: z4k, szs8k, s4k, 4k

外部图床类别和anime 混合类别不支持 type 参数。

响应

200 / 请求成功

成功！将随机图片以图片二进制 (image/jpeg) 直接返回给客户端，可直接在 标签中使用。

image/jpeg
图片响应说明
Response · Image/JPEG
这是什么

接口返回的是图片的二进制数据流，而非 JSON 对象。客户端在接收到响应后，需要将其作为图片文件进行解析和处理。

前端展示方案

在浏览器环境中，最标准的做法是将响应体读取为 Blob 对象，并通过 URL.createObjectURL 生成一个临时的本地访问地址，最后将其赋值给 <img> 标签。为了避免内存泄漏，建议在图片加载完成后释放该 URL。

TYPESCRIPT
Node.js 服务端保存方案

如果是在 Node.js 环境中调用该接口，可以将响应转换为 ArrayBuffer，再转为 Buffer 并写入本地文件系统。

TYPESCRIPT

404 / 未找到

未找到指定类别的图片。

JSON

500 / 服务器内部错误

服务器内部错误。

JSON
下一篇随机字符串