随机

随机图片

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服务器)

如果不指定,将从所有图片中随机抽取(不包含ikunai_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