二次元随机图片API整合

📚 全网最全二次元随机图片API整合指南 | 开发者必收藏
本文整合 16个平台20+个接口,涵盖动漫壁纸/表情包/IP签名等场景,提供 调用示例+合规指南

一、基础型API(直连即用)

分类

接口地址

参数说明

极简随机

https://www.dmoe.cc/random.php

支持type=json返回数据结构

晓晴图库

https://acg.toubiec.cn/random.php

可指定尺寸:width=1920&height=1080

搏天随机

https://api.btstu.cn/sjbz/api.php

添加format=json获取作者信息

墨天逸

https://api.mtyqx.cn/tapi/random.php

古风插画专库,type=1切换模式

Python调用示例

import requests
def get_dmoe_img():
    res = requests.get("https://www.dmoe.cc/random.php")
    return res.url  # 直接返回图片URL

二、主题扩展型API

1. 综合图库

平台

接口地址

特色

夏沫博客

https://cdn.seovx.com/?mom=302 (常规)
https://cdn.seovx.com/ha/?mom=302 (高清)

302重定向模式,适配CDN加速

樱道全系列

https://api.r10086.com/动漫综合1.php

需访问官网查看30+分类接口

动漫星空

https://api.dongmanxingkong.com/suijitupian/acg/1080p/index.php

东方Project专题资源

2. 特色功能

功能

接口地址

参数示例

必应每日一图

https://api.isoyu.com/bing_images.php

size=uhd 获取4K分辨率

ARU表情包

https://api.isoyu.com/ARU_GIF_S.php

type=1 静态图模式

动态IP签名

https://api.isoyu.com/ip_images.php?signature=早安

替换"早安"生成个性化签名

三、认证型API

平台

文档地址

调用方式

Unsplash

官方文档

GET /user-12345/likes 获取用户收藏

保罗API

https://api.paugram.com/wallpaper/

Header添加 X-Key: 您的密钥

EEE.DOG

https://api.yimian.xyz/img

使用OAuth 2.0认证,需申请客户端ID

CURL示例

curl -H "X-Key: YOUR_KEY" https://api.paugram.com/wallpaper/?category=anime

四、自建方案推荐

1. 姬长信Docker部署

version: '3'
services:
  acg-api:
    image: changxin/acg-serve:latest
    ports:
      - "8080:3000"
    environment:
      - API_KEY=your_password

2. 岁月小筑架构

代理层:Nginx (处理HTTPS)
存储层:AWS S3 + CloudFront CDN
鉴权:JWT Token动态校验

五、合规使用规范

  1. 版权声明

    • Pixiv来源图片需在页面添加 <span>Artwork by @作者ID</span>

    • Unsplash遵循 CC0协议

  2. 流量控制

    # Nginx限流配置示例
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=5r/s;
    location /api/ {
        limit_req zone=api_limit burst=10;
    }
    
  3. 缓存策略

    // 前端浏览器缓存示例
    fetch(url, { 
      headers: new Headers({
        'Cache-Control': 'max-age=3600'
      })
    });
    

避坑指南

  • 避免直接使用img标签调用接口,推荐后端代理转发防止泄露IP

  • 国内服务器部署时,夏沫博客302接口需备案域名

  • 墨天逸API返回403时,添加 Referer: https://yourdomain.com