随机图片API - 使用教程

API概述

随机图片API提供了简单、高效的接口，让您可以轻松获取各种分类的高质量图片。所有请求都使用302重定向到实际的图片URL，减少服务器资源消耗。

高效轻量

每次请求仅返回302重定向，不消耗服务器带宽

<极div class="bg-success text-white rounded-circle p-2 me-3">

设备自适应

自动检测用户设备类型返回合适尺寸的图片

分类丰富

多种图片分类可供选择，满足不同场景需求

使用步骤

获取随机图片

最基本的API调用，不指定任何分类，系统会根据设备类型返回随机图片。

请求示例：

GET https://cs05.cn/api/

响应示例：

HTTP/1.1 302 Found

Location: https://example.com/random-image.jpg

获取特定分类的图片

通过category参数指定分类名称，系统会返回该分类下的随机图片。

请求示例：

GET https://cs05.cn/api/?category=自然风景

响应示例：

HTTP/1.1 302 Found

Location: https://example.com/nature-image.jpg

在网页中使用

在HTML中使用<img>标签直接调用API：

<img src="https://cs05.cn/api/?category=自然风景" alt="随机自然风景">

在CSS中使用

在CSS中使用API作为背景图片：

.banner {
    background-image: url('https://cs05.cn/api/');
    background-size: cover;
}

API参数说明

参数名	必需	说明
`category`	可选	指定分类名称，返回该分类下的随机图片
`device`	可选	强制指定设备类型（pc/mobile）
`format`	可选	返回格式（json/redirect），默认redirect

可用分类

以下是系统中所有启用的分类：

QWQ

使用示例：

<img src="https://cs05.cn/api/?category=QWQ">

API使用限制

API调用无次数限制
图片URL通过302重定向返回
确保使用有效的分类名称
自动根据设备类型返回图片
支持JSON格式返回图片信息

提示： 您可以在调用统计页面查看API使用情况

API使用教程