自制的一些免费API接口第二弹（获取QQ昵称、头像、抖音/豆包视频去水印等...）

引言

为了让 Hexo 这个静态博客变得更有“灵气”，我动手搭建了自己的 API 服务 —— api.hzv5.cn。它现在已经集成超过 27 种实用的免费接口[reference:1]，从媒体解析到 AI 工具，让我的博客能实时调用各种动态数据。上一次收集整理和自制的api接口获得很多人的喜爱，那么，今天就把这个自制的“工具箱”第二弹分享出来，并手把手教大家如何把它接入到 Hexo 主题中，或许运用到自己的一些项目中。

API接口：概览与分类

api.hzv5.cn 是一个完全免费、无需注册的接口站，所有接口都可以直接在浏览器或代码中调用。目前提供的接口主要分为以下几类：

1. 智能工具 (AI & Utility)

艺名生成器 (/artname.php): 根据你的姓名或文本，智能生成 1-5 个中文或英文艺名并附带解释[reference:2]。
答案之书 (/answer.php): 获取随机经典语录，用于解惑或娱乐[reference:3]。
体感温度计算 (/feel.php): 基于温湿度等数据，计算体感温度并提供生活建议[reference:4]。
随机评论生成 (/random_comment.php): 获取预设的随机评论内容，可以当作网站的填充语[reference:5]。
敏感词检测与过滤 (/mg.php): 支持多种检测模式，可对文本进行脱敏、替换或分类统计[reference:6]。

2. 主流平台解析

抖音解析:
- 视频/图文: 输入抖音链接，解析视频、图集或实况内容，提取无水印素材与作者信息[reference:7]。
- 主页作品: 获取指定用户主页的所有作品列表[reference:8]。
- 直播: 查询直播间信息与实时流地址[reference:9]。
豆包解析:
- 视频去水印: 解析豆包视频的分享链接，提取无水印地址[reference:10]。
- 图片去水印: 解析分享链接，获取对话中的无水印图片[reference:11]。
蓝奏云直链解析 (/lanzou.php): 将蓝奏云分享链接转为文件直链[reference:12]。

3. 数据查询服务

IP 归属地查询 (/ip_lookup.php): 查询 IPv4 地址的地理位置[reference:13]。
百科查询 (/bk.php): 获取词条的简要摘要（纯文本）[reference:14]。
历史上的今天 (/history.php): 获取指定日期发生的大事记[reference:15]。
快递查询 (/kd_protect.php): 根据单号查询物流信息[reference:16]。
QQ 信息获取 (/qqnote.php): 查询 QQ 号的昵称与头像[reference:17]。
实时金价 (/gold_price.php): 获取国际现货黄金实时价格[reference:18]。
天气查询 (/weather.php): 根据城市获取实时天气[reference:19]。

4. 实用小工具

UA 设备识别 (/ua.php): 解析 UA 字符串，返回设备、OS 和浏览器信息[reference:20]。
成语接龙 (/idiom_jielong.php): 自定义模式和长度进行成语接龙[reference:21]。
文本加密 (/textencryption.php): 使用专属密钥加密文本[reference:22]。
随机数据：颜色(/ys.php)[reference:23]、密码(/randomcode.php)[reference:24]。
二维码：生成(/qr.php)与解析(/qr.php)[reference:25]。
折扣凑单计算 (/zhekou.php): 根据满减规则计算最优凑单方案[reference:26]。
Zepp 步数刷步 (/zepp.php): 通过 Web 端 API 提交步数[reference:27]。

在 Hexo 主题中集成

嵌入方法很简单，只要找到主题里合适的 .ejs 或 .pug 模板文件，添加 fetch 代码即可[reference:28]。

实用场景示例

1. 在侧边栏显示“答案之书”

在 layout/_partial/sidebar.ejs 中添加：

<div class="side-sentence">
    <p id="api-text">加载中…</p>
</div>
<script>
    fetch('https://api.hzv5.cn/answer.php?format=json')
        .then(res => res.json())
        .then(data => {
            document.getElementById('api-text').innerText = data.data;
        })
        .catch(() => {
            document.getElementById('api-text').innerText = '顺其自然';
        });
</script>

2. 在页脚显示一句随机的搞笑评论

在 layout/_partial/footer.ejs 中添加：

<div id="random-comment" style="margin-top: 10px; font-size: 12px; text-align: center;">✨ 加载中...</div>
<script>
    fetch('https://api.hzv5.cn/random_comment.php?format=json&count=1')
        .then(res => res.json())
        .then(data => {
            if(data.code === 0) {
                document.getElementById('random-comment').innerHTML = `💬 ${data.data}`;
            }
        })
        .catch(() => {
            document.getElementById('random-comment').innerHTML = '💬 代码如诗，博客如画';
        });
</script>

3. 创建“今日运势”等创意模块

用户访问时通过 answer.php 或 artname.php 获取随机内容，增加互动趣味。

使用须知

免费服务并不意味着可以无节制使用，所有调用都是公开透明的，请合理调用、请勿滥用。建议在请求时设置超时处理，并做好请求失败的容错，以免影响页面整体加载。

功能扩展

除了增强 Hexo 博客，这些接口还能用于：

· 微信机器人：快速接入视频解析等功能。
· 自动化脚本：定期获取金价或天气数据。
· 移动应用：将 api.hzv5.cn 作为小工具的后端。

总结

未来我会根据大家的需求，继续增加更多有趣、实用的接口。

如果在使用中遇到任何问题，或有新的接口需求，欢迎随时交流。