随机图片api分享

发布于 2020-12-19  34 次阅读


简介

  • 当前图片库包含1700+ 动漫图片,图片托管于腾讯云cos,并开启cdn加速。
    Api部署在腾讯云云函数,支持图片关键字搜索,可选302跳转返回图片或直接返回。

API 地址

特性

  • 图片放置在腾讯云对象存储,并且开启全球cdn加速。
  • 返回图片支持数据万象图片处理。
  • 使用神经网络生成图片标签。
  • 支持关键字与标签搜索(源图片标签是英文)。
  • 支持搜索词翻译,采用腾讯AI自然语言处理接口。
  • 支持图片参数过滤(长宽,图片大小,图片分级)。

返回格式

  • 本API支持网页直接返回图片(从API处直接获得,由于API部署在腾讯云广州地区,全国访问速度可能有差异)
  • 本API还支持302,301跳转,跳转链接为腾讯云对象存储地址,访问速度对全球优化。
  • 对于直接返回图片的方式,图片具体参数和查询时间可通过Http header查看,具体格式如下。
Http Header Value
X-Image-Query-Status
API调用是否成功
X-Image-Rating
图片分级(暴露程度)
X-Image-Category
图片类别(目前只有动漫)
X-Image-Size
图片大小(长宽)
X-Image-DHash
图片哈希值
X-Image-Query-Time
图片查询时间

参数列表

参数名称 描述 格式 示例
cat
图片类别 (目前只有动漫)

Anime

cat=Anime
isize
目标图片尺寸大小

w>??(a)h>??

isize=w>1000(a)h>1000
fsize
目标图片文件大小 (单位kb)

>??

fsize=>1000, fsize=<1000
rating
目标图片暴露程度

n / h / p

rating=nh, rating=n
tags
目标图片标签

tag1(a)tag2(o)tag3......

tags=saber(o)rem
shape
目标图片形状

pc / mobile / none

shape=pc
get
图片返回方式

fetch / 302 / 301

get=fetch
func
数据万象图片处理
func=?imageMogr2/blur/8x5
trans
是否开启标签翻译

t / f

trans=t

参数详解

cat

isize

fsize

rating

tags 和 trans

  • tags默认无,trans默认不开启
  • tags同样支持逻辑符号(a)和(o),同时支持圆括号,例如 (rem(o)saber)(a)water 代表返回雷姆或者saber的图片,并且返回的图片里面都要有水元素
  • 由于数据库中的标签都是英文,如果想要用中文查询,需要设置trans=t,开启翻译会调用腾讯ai的翻译api,增加图片返回时间,所以当查找关键字为英文的时候最好不要开启
  • 示例1:https://img.scf.ioalzx.site/getImg?tags=saber(o)rem
  • 示例2:https://img.scf.ioalzx.site/getImg?tags=saber(o)贞德&trans=t

shape

get

func

报错提示

  • 当找不到所要求的图片以及api内部出错时,标头X-Image-DHash 会变为Error 并且返回如下图片