API 简介
浪心随机图片 API 是一个高性能、多分类的随机图片服务。采用 Go 语言重构，支持高并发访问，平均响应时间 < 50ms。
核心特性：
- ✨ 完全免费，无需注册
- 🚀 高性能 Go 服务，支持高并发
- 📦 支持 JSON 和图片直链两种响应模式
- 🎯 多分类支持，满足不同场景需求
- 🔄 支持图片去重和冷却时间
- 💾 Redis 缓存，响应迅速
快速开始
只需 3 步，即可开始使用浪心随机图片 API：
1. 选择图片分类
从我们提供的多个分类中选择一个，例如：ecy（二次元）、pcbz（电脑壁纸）等。
2. 构建 API 请求
使用以下格式构建请求 URL：
https://www.lxtu.cn/api/?name=分类代码
3. 发起请求
在浏览器中访问该 URL，或在代码中使用该 URL 作为图片源。
参数说明
请求格式
GET /api/?name={category}&type={type}&quantity={quantity}&repeat={0|1}&cold
Host: www.lxtu.cn
参数列表
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
name |
string | 必需 | 图片分类名称（见下方分类列表） |
type |
string | 可选 | 响应类型：image 图片直链（默认）| json JSON 数据 |
quantity |
number | 可选 | 返回图片数量，1-50，默认 1（仅 JSON 模式有效） |
repeat |
string | 可选 | 是否允许重复：0 不允许 | 1 允许（默认） |
cold |
boolean | 可选 | 启用冷却时间（30秒内不重复），添加此参数即启用 |
图片分类
| 分类代码 | 分类名称 | 描述 |
|---|---|---|
ecy |
二次元美图 | 精选二次元动漫高清美图 |
pcbz |
电脑壁纸 | 精美高清电脑桌面壁纸 |
mn |
猫娘图集 | 萌萌哒猫娘角色图集 |
ys |
原神壁纸 | 原神游戏角色高清壁纸 |
fj |
风景摄影 | 世界各地自然风光摄影 |
cat |
猫咪写真 | 萌宠猫咪高清写真 |
使用示例
1. 在 HTML 中使用（图片直链）
最简单的方式是直接将 API 地址作为图片的 src：
<img src="https://www.lxtu.cn/api/?name=ecy" alt="随机图片">
2. 获取 JSON 格式数据
curl https://www.lxtu.cn/api/?name=pcbz&type=json
响应示例：
{
"status": "success",
"data": {
"parameters": {
"category": "pcbz",
"type": "json",
"quantity": 1
},
"images": [
{
"url": "https://example.com/image1.jpg",
"filename": "image1.jpg"
}
],
"metadata": {
"selected": 1,
"available": 500,
"total": 500,
"generated_at": "2024-01-01T12:00:00Z"
}
}
}
3. 在 JavaScript 中使用
fetch('https://www.lxtu.cn/api/?name=cat&type=json')
.then(res => res.json())
.then(data => {
const imageUrl = data.data.images[0].url;
document.getElementById('myImage').src = imageUrl;
});
4. Python 调用示例
import requests
# 获取 JSON 数据
response = requests.get('https://www.lxtu.cn/api/?name=ecy&type=json')
data = response.json()
image_url = data['data']['images'][0]['url']
print(f'图片 URL: {image_url}')
# 下载图片
img_response = requests.get(image_url)
with open('image.jpg', 'wb') as f:
f.write(img_response.content)
在线测试
选择一个分类，点击按钮即可测试 API 并查看返回的图片。
点击上方按钮加载随机图片
图片信息
常见问题
Q: 图片加载失败怎么办？
A: 可能的原因：
- 分类名称输入错误
- 该分类暂无可用图片
- 图片源链接失效（我们会定期更新）
<img> 标签中添加 onerror 处理。
Q: 有调用次数限制吗？
A: 目前没有严格的调用限制，但请合理使用，避免恶意刷接口影响服务稳定性。
Q: 图片是否有版权问题？
A: 图片资源来自互联网，请注意版权问题，仅供个人学习和测试使用。商业使用请自行确认版权。
Q: 为什么切换到 Go 语言？
A: Go 语言具有以下优势：
- 更高的并发性能，支持大量同时访问
- 更低的响应延迟（< 50ms）
- 更好的资源利用率
- 更稳定的服务运行
最佳实践
- 缓存图片 URL：在应用中缓存获取到的图片 URL，避免频繁请求 API。
- 错误处理：始终添加错误处理逻辑，提供备用图片或重试机制。
- 懒加载：对于页面中的多张图片，使用懒加载技术优化性能。
- 使用 JSON 模式：如果需要获取多张图片或更多信息，使用 JSON 模式更灵活。
- 合理设置数量：不要一次请求过多图片，建议每次不超过 20 张。