随机

获取随机图片(重定向)

0次调用

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

GET
uapis.cn
/api/v1/random/image
查询参数
2
category
string

(可选)指定图片主类别。

支持的主类别:

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

如果不指定,将从所有图片中随机抽取(不包含ikunai_drawing)。

type
string

(可选,仅UapiPro服务器图片支持)指定图片子类别。

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

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

功能概述

这是一个非常简单的接口,它会从我们庞大的图库和精选外部图床中随机挑选一张图片,然后通过 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} 接口。

支持的主类别与子类别

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

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

查询参数

category
string

(可选)指定图片主类别。

支持的主类别:

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

如果不指定,将从所有图片中随机抽取(不包含ikunai_drawing)。

type
string

(可选,仅UapiPro服务器图片支持)指定图片子类别。

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

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

响应

302 / 临时重定向

成功!你的客户端将会被重定向到一张随机图片的URL。

404 / 未找到

未找到指定类别的图片。

500 / 服务器内部错误

服务器内部错误。