加载中...

稳定运行 2000+ 天

随机图片直链API
极简接入 · 毫秒响应

提供高质量、多分类、多格式的随机图片直链服务，无需解析JSON，一行代码即可集成到你的应用、网站或小程序中

立即体验开发文档

极速响应

平均响应时间 < 100ms，CDN加速分发，全球快速访问

丰富分类

10+ 图片分类，覆盖自然、城市、动物、艺术等多种场景

稳定可靠

99.9% 可用性保障，自动容灾备份，支持高并发访问

API实时演示

当前版本：加载中...

图片分类

图片格式待实现

图片尺寸待实现

未选择图片

点击按钮获取随机图片

API直链

开发者文档

基础用法

直接访问以下URL即可获取随机图片（直链返回二进制数据）：

${BASE_URL}/random

按分类筛选

通过type参数指定分类：

${BASE_URL}/random?type=nature

支持的分类：

按格式筛选待实现

通过URL参数指定图片格式：

${BASE_URL}/random?format=png

高级参数说明

参数名	类型	默认值	状态	说明
format	string	无	待实现	图片格式：jpg/png/gif/webp
size	string	original	待实现	图片尺寸：small/medium/large/original
exclude	string	无	待实现	排除指定图片ID，多个用逗号分隔
refresh	boolean	false	待实现	是否强制刷新缓存：true/false
type	string	无	已实现	按分类筛选图片，未传输则从所有分类里随机挑选图片返回

组合使用示例

${BASE_URL}/random?type=nature&format=jpg&size=medium

响应说明

状态码	说明	响应类型	响应示例
200	成功返回图片	图片二进制数据	-
404	分类不存在/无图片	JSON	{"code":404,"msg":"分类不存在","data":{"error_id":"2026021012345-abc1","error_time":"2026-02-10 12:34:56","category":"xxx"}}
500	服务器内部错误	JSON	{"code":500,"msg":"服务器内部错误","data":{"error_id":"2026021012345-abc2","error_time":"2026-02-10 12:34:56"}}
400	请求参数非法	JSON	{"code":422,"msg":"非法请求","data":{"request_id":"2026021012345-abc3","error_time":"2026-02-10 12:34:56","reason":"xxx"}}

响应头说明

Content-Type：图片MIME类型（image/jpeg、image/png、image/gif、image/webp等）
Content-Length：图片文件大小（字节）
Cache-Control：no-cache, max-age=0（不缓存，确保每次请求都返回随机图片）
Access-Control-Allow-Origin：*（支持跨域访问）

多语言使用示例

HTML

<img src="${BASE_URL}/random?type=nature&format=jpg" alt="自然风光">


<img src="${BASE_URL}/random?type=city&size=medium" alt="城市建筑" width="800" height="600">

JavaScript

// 动态加载随机图片
function loadRandomImage() {
  const img = document.createElement('img');
  img.src = '${BASE_URL}/random?type=animal&format=png';
  img.alt = '随机动物图片';
  img.className = 'random-img';
  document.getElementById('image-container').appendChild(img);
}

// 调用函数
loadRandomImage();

Python

import requests

# 获取随机图片并保存
def save_random_image():
  url = '${BASE_URL}/random?type=art&format=webp'
  response = requests.get(url)
  if response.status_code == 200:
    with open('random_art.webp', 'wb') as f:
      f.write(response.content)
    print('图片保存成功')
  else:
    print(f'请求失败：{response.status_code}')

save_random_image()

PHP

<?php
// 获取随机图片URL
$category = 'food';
$format = 'jpg';
$url = "${BASE_URL}/random?type={$category}&format={$format}";

// 输出图片标签
echo "<img src='{$url}' alt='随机美食图片'>";
?>

图片分类预览

第 1 / 1 页

分类图片列表

第 1 / 1 页

API使用统计待实现

总请求次数

12,589,478

较上月增长 18.5%

图片总数

8,742

本周新增 128 张

活跃用户

24,856

昨日新增 328 人

分类访问量统计

月度访问趋势

用户反馈

提交反馈

常见问题

API如何使用？

直接访问 ${BASE_URL}/random 即可获取随机图片，支持分类筛选和格式过滤。

图片可以商用吗？

所有图片均为用户上传图片，不可用于任何商业项目中。

有访问频率限制吗？

为防止滥用，每个IP每分钟最多可请求60次，超出限制将返回429错误。

如何获得更快的响应速度？

API已在全球部署CDN节点，自动选择最近节点，确保毫秒级响应。

随机图片直链API 极简接入 · 毫秒响应