古诗词·一言 API:一句诗的接口

为你的博客引入——今日诗词、每日一言(js插件分享) 文章目录一、今日诗词二、每日一言 一、今日诗词 今日诗词API,是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐。 官网:www.jinrishici.com <h1> 念两句诗</h1> <p id="poem"> 叙... 阅读详情

古诗词·一言 API:一句诗的接口

gushici 在 GitHub 上已经拿到 1,383 Star 了。

xenv 开源了这个项目,专门干一件事——随机返回一句古诗词名句。Vert.x 异步框架加 Redis,毫秒级响应,支持 svg、txt、json、png 四种返回格式。

正文顶部截图

1、 这玩意儿是干嘛的

给你一个接口,调用一次返回一句古诗词。

应用场景蛮多的。博客侧边栏挂一句诗、小程序首页做点缀、论坛签名当随机展示、个人网站顶上一行装饰文字,都能直接接进去。SVG 方式可以在博客和论坛里无损直接调用,PNG 方式兼容性最好几乎所有地方都能插,JSON 方式拿到来源、作者、分类等结构化字段供你自己拼接显示。

2、 为什么用这个

要自己搭一个不算难,写个随机接口谁都会。难的是数据和稳定性。

诗词名句数据由古诗文网收录整理,分门别类放进 Redis 里。整套服务跑过数百万次调用,单元测试齐全,单机压测能跑到 2 万 QPS。E5 2660 八核十六线程机器上跑一百万次请求平均响应 4 毫秒,错误率 0。

如果你只是想要一句诗挂页面上,没必要自己采数据自己维护服务,调一下就行。

3、 怎么调用

接口地址格式:

https://v1.jinrishici.com/{一级分类}/{二级分类(可选)}.{返回格式(可选)}

支持的分类全部列在这里:https://v1.jinrishici.com/,可以用抒情、人生、离别、思乡、爱情、季节这些一级分类去取。

README区域截图

最简单的用法,HTML 里直接一行:

<img src="https://v1.jinrishici.com/all.svg">

想要自定义字体大小和字间距,加参数:

<img src="https://v1.jinrishici.com/all.svg?font-size=18&spacing=4">

字体大小 8 到 50 像素可选,字间距 0 到 30 像素可选,默认 20 像素和 1.5 像素。

要 JSON 格式自己拼接显示,一个 XMLHttpRequest 就拿到结果:

<script>
  var xhr = new XMLHttpRequest();
  xhr.open('get', 'https://v1.jinrishici.com/all.json');
  xhr.onreadystatechange = function () {
    if (xhr.readyState === 4) {
      var data = JSON.parse(xhr.responseText);
      document.getElementById('gushici').innerText = data.content;
    }
  };
  xhr.send();
</script>

JSON 返回里带作者、来源、分类,可以自己拼成任何排版。TXT 调用和 JSON 几乎一致的写法,省掉解析那步,流量的消耗更小一些。PNG 调用则是最兜底的方式,所有浏览器所有平台都支持,缺点是没法改样式,图片传输体积也被流量策略压得比较小。

4、 想自己部署也行

项目本身开源,本仓库提供测试数据。Maven 装依赖,maven package 打成 fat jar,配置好 Redis 把 dump.rdb 导进去,启动命令跑起来:

java -server -jar yiyan-1.0-fat.jar -conf conf.json

要 IDE 调试,启动类 io.vertx.core.Launcher,参数 run ma.luan.yiyan.MainVerticle -conf src/main/resources/conf.json。

想自己采数据也可以,照着原有 Redis 里的 key 格式来。每个分类一个 set,set 里存 json 字符串或者 base64 加密的图片。日志会自动添加,help 字段可选,其余字段自己填 json 和 img 两个 key 集。

5、 一点版本历史

2018 年 8 月初版本上线,1.0 支持四种格式返回和分类搜索。

1.1 引入前缀树,分类检索从 O(n) 优化到 O(L),n 为分类总数,L 为分类级数。代价是空间复杂度从 O(n) 涨到 O(nL),代码多了六十行。同一次更新里规范了地址参数的正则匹配,补全了全局错误处理覆盖 Router 和 EventBus 两条路径。

1.3 让 SVG 支持自定义字体大小和字间距。1.4 补全单元测试、优化启动流程、升级依赖版本。

6、 已经有新版了

作者另外做了一个今日诗词 API,地址 https://www.jinrishici.com,不开源但免费调用。

新版可以根据地点、时间、节日、季节、天气、景观、城市做智能推荐。Gushici 这个仓库继续开源维护,给想要自建或者跑测试数据的人用。

名句数据由古诗文网整理,特此致谢。

新版可以根据地点、时间、节日、季节、天气、景观、城市做智能推荐。Gushici 这个仓库继续开源维护,给想要自建或者跑测试数据的人用。

名句数据由古诗文网整理,特此致谢。

js插件之今日诗词、每日一言 最近搭建了一个自己的博客网站,做一些必要的笔记,一来是对自己学习的知识的巩固,二来对有同样问题的人有参考作用 文章目录一 今日诗词二 每日一言三 总结 一 今日诗词 今日诗词API,是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐。 官网:www.jinrishici.com ... 阅读详情

相关推荐

基本能用的免费接口API

不知道能不能用,有的可以,收藏之。 音乐搜索接口:https://api.apiopen.top/searchMusic?name=雅俗共赏 音乐排行榜接口:https://api.apiopen.top/musicRankings 随机古诗词接口: https://api.gushi.ci/all.json 天气获取接口: https://www.apiopen.top/weatherApi?city=上海 美图获取接口: https://www.apiopen.top/meituApi?pag

trjune的博客 1444

10 种主题随机诗词:一个 API 解决小程序的诗词内容源

本文记录了对接「随机诗词」API的全过程:首先通过Postman测试基础请求,了解返回结构;重点分析了10种主题筛选参数的使用方式;随后用Node.js + axios封装了可复用的请求函数,支持主题过滤和批量获取;最后分享了调试踩坑经验(Token安全、超时设置等)和前端展示建议。整个过程从接口分析到代码实现,为开发者提供了完整的第三方API接入参考方案。

Roufsi的博客 262

免费古诗词查询接口推荐:含国内稳定方案

【实测可用的免费古诗词接口推荐】本文提供2026年8月实测有效的三种免费方案:1. 万维易源接口1620(需免费appKey),支持按朝代/诗人/诗名结构化检索;2. 今日诗词jinrishici(免key),适合随机展示诗词;3. 开源自建ChinesePoetryAPI(需部署),含40万首诗词全文检索能力。文中包含接口参数对比、场景选型建议及Python/cURL调用示例,所有方案均通过实时请求验证可用性,避免开发者使用失效接口。

APIsmileJ的博客 421

【亲测免费】 探索古诗魅力:一言·古诗词 API

![一言·古诗词 API](https://v1.jinrishici.com/all.svg) ## 项目简介 **一言·古诗词 API** 是一款匠心独运的开源项目,它能随机返回一句古代诗词名句,为你的应用注入文化气息。基于 Java 的 Vert.x 全异步框架构建,结合 Redis 数据库,确保了快速、稳定的服务响应。不仅如此,它还提供了多样化格式的调用方式,适应不同场景的需求。 项...

gitblog_00088的博客 1121

一行Docker命令部署40万首古诗词API:从部署到接入的实战记录

在应用开发中,数据获取与清洗往往比业务逻辑更耗时,尤其是涉及古籍诗词这类非结构化文本时,编码混乱、字段缺失、来源分散等问题层出不穷。容器化技术通过镜像打包数据、运行环境与服务进程,显著降低了部署门槛,也为数据服务提供了高内聚的API抽象——开发者只需通过HTTP接口即可完成检索,无需关心底层存储与依赖。古诗词API以Docker镜像形式分发,内置数十万首诗词数据,支持作者、朝代、体裁、关键词等多维度查询,适合教育应用、个人博客或离线环境使用。本地部署不仅摆脱了第三方接口的频率限制,也保证了数据可控性与服务稳

weixin_27697385的博客 272

分享一些免费调用的API接口

以下是网络收集的一些免费的接口,测试过一些可用,但是不是非常稳定,使用稳定的还是建议大家使用付费的。 快递查询:https://api.apiopen.top/EmailSearch?number=1012002 随机单句诗词推荐:https://api.apiopen.top/singlePoetry 随机一首诗词推荐:https://api.apiopen.top/recommendPoetry 搜索古诗词:https://api.apiopen.top/searchPoetry?name=古风二首

疾术客 2752

一言·古诗词 API 项目常见问题解决方案

该项目是一个名为“一言·古诗词 API”的开源项目,旨在提供随机返回一句古诗词名句的接口。项目使用 Java 作为主要编程语言,并基于 Vert.x 框架和 Redis 数据库进行全异步开发。 ## 新手常见问题及解决步骤 ### 问题一:项目依赖和环境配置 **问题描述**:新手在搭建项目时可能会遇到项目依赖和环境配置的问题。 **解决步骤**: 1. 确保安装了 Java 开发工具包(...

gitblog_00214的博客 493

告别Keil4!手把手教你用Keil C51 V9.61编译51单片机代码(附最新激活方法)

本文详细介绍了Keil C51 V9.61在51单片机开发中的全栈升级指南,包括编译速度提升、调试器性能优化和现代开发支持等核心优势。通过智能安装方案、项目迁移实战和新特性深度应用,帮助开发者告别Keil4,大幅提升开发效率。附有最新激活方法和实用技巧,适用于嵌入式开发工程师。

weixin_26886855的博客 422

古诗词·一言API vs 今日诗词API:开源与商业版功能对比

古诗词·一言API是一个开源的随机返回古诗词名句的接口服务,采用Vert.x Java全异步框架开发并结合Redis数据库,确保毫秒级稳定响应。而今日诗词API作为其商业升级版,提供了更智能的推荐功能。本文将从功能特性、技术架构、使用场景等维度对比两款API的差异,帮助开发者和爱好者选择最适合自己需求的解决方案。 ### 核心功能对比:开源基础版 vs 商业智能版 #### 古诗词·一言API

gitblog_00336的博客 404

S32K144 ADC硬件触发实战:PDB与TRGMUX配置避坑指南

本文深入解析了S32K144微控制器中ADC硬件触发的两种核心方案:PDB与TRGMUX。通过对比其架构差异、详细配置流程及常见问题排查,提供了从寄存器操作到DMA联动的完整优化指南,旨在帮助开发者解决多通道采样时序不稳、CPU负载过高等实际难题,实现高效稳定的数据采集。

weixin_29168153的博客 445

【深度避坑】Word 提示“内存或磁盘空间不足,保存失败”的真正原因与终极解决方案

这是 Word 2003 时代的老功能⚠现代 Office 使用全新的保存 API(与 OneDrive 深度集成)老插件无法兼容现代保存机制会拦截 Word 的写入流程导致保存动作失败,Word 误以为磁盘坏了,于是报错不是磁盘坏了,是 Word 被插件绊倒了。Word 无法保存 = 加载项冲突(尤其是书法 / 稿纸向导)。永久禁用即可彻底恢复。如果在写毕业论文、要交文档,强烈建议马上检查一下你的加载项,避免后期出现大规模崩溃丢稿。

m0_59029415的博客 3080

hexo(next)——每日一言、今日诗词

本文转载于姑の小屋,稍加修改。 云开的博客原文:https://chenyunxin.cn/posts/4200755795.html 欢迎访问我的博客交流哟????:https://chenyunxin.cn/ ????今日诗词    今日诗词API,是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、...

cloudYun的博客 2306

使用cartographer纯定位替换amcl定位

经过实际使用,发现cartographer定位对于重定位的表现比amcl好。如果机器人的起始位置离原点较远,amcl很难自行重定位到正确的位置,只能手动修改初始位置。然而cartographer定位的表现则很好,在行驶一段距离或原地旋转一段时间后能够正确重定位。

XJ_75的博客 8313

古诗词API终极指南:如何从零构建毫秒级响应诗词接口

古诗词API(一言·古诗词API)是一个基于Vert.x和Redis的高性能全异步接口,能够随机返回古诗词名句,提供毫秒级的稳定响应。这个开源项目支持多种格式调用,包括SVG、JSON、PNG和TXT,可以轻松集成到网站、博客和小程序中。 ## 🚀 项目核心优势 ### 闪电般的响应速度 采用Vert.x Java全异步框架开发,结合Redis数据库,确保每次调用都能在毫秒级别完成。经过百万

gitblog_01100的博客 1193

深入详细分析Skyworks 78113 PAMiD射频方案图

是一种高集成度的射频前端模块,它结合了功率放大器(PA)、双工器(Duplexer)、滤波器和开关等多个组件,主要用于4G LTE移动通信系统中的射频前端链路。是一款典型的PAMiD模块,通过将多个频段的发射(TX)和接收(RX)路径集成在一个模块中,大大减少了传统射频设计中的分立器件,同时提高了信号链路的效率和可靠性。模块化设计的优势PCB空间优化:高集成度设计大幅减小了射频电路的尺寸,适用于紧凑型移动设备。减少设计复杂度:模块化设计减少了器件间的匹配与调试工作,加速产品开发周期。性能稳定性。

weixin_43199439的博客 1483

本地玩转AI还得靠这个,SillyTavern(酒馆)到底有多强?

SillyTavern是一款本地运行的LLM交互前端,支持文本生成、图像生成、语音合成等功能。它最初是TavernAI的分支,现已独立开发,社区活跃,功能更新频繁。SillyTavern通过前端UI和插件系统连接各种大模型后端,如OpenAI、KoboldAI等,用户可以在本地创建“虚拟酒馆”与各种角色对话。其功能亮点包括角色卡、角色记忆、世界设定、多人聊天室、自定义UI和行为脚本、插件扩展支持等。SillyTavern适合AI创作用户、AI工程师、LLM爱好者和AIGC创作者。它有两个维护分支:relea

代码简单说 Vue、JAVA、PHP、Node.js 熟练运用,接口、架构、性能全搞定。 8058

诗泉chinese-poetry-api:一条Docker命令服务40万首古诗词,高性能中国古诗词API完全解析

诗泉(chinese-poetry-api)是一个基于 Go 语言开发的高性能中国古诗词 API 服务。只需一条 Docker 命令,你就能在自己的服务器上搭建起一个覆盖唐诗、宋词、元曲等近 40 万首诗词的查询接口,支持全文搜索、简繁切换和 GraphQL 查询,是诗词爱好者、爬虫练习者和应用开发者的免费基础设施。 [![诗泉chinese-poetry-api古诗词API项目印章](http

gitblog_00020的博客 89

WPF实战案例 | C# WPF实现大学选课系统

WPF实战案例_C# WPF实现大学选课系统, C# WPF实现大学选课系统,大作业,毕业设计,该系统实现多身份登录、修改密码、课程的管理,个人信息的管理等功能。这个源码让你快速搭建自己的应用程序,注释完整,代码规范,各种风格都有,代码上手简单,代码独立,可以直接用程序打开,运行使用。也可直接点击EXE运行程序。

不踩坑,不知道坑有多深;不总结,踩过的坑白踩。 4625

一言(Hitokoto)API 实战指南:一行代码给网站加上「每日一句」

一言(Hitokoto)是免费、免注册的开放 API,每次请求随机返回一句话。本文详解请求地址、参数、12 种分类与返回字段,并给出 cURL / HTML / JavaScript / Python / Node.js 多语言实战(输出均为真实数据),附超时降级、缓存等最佳实践与托管聚合版选型。

Roufsi的博客 781

【RTD】AD7793两线式铂电阻PT100/PT1000应用

两线式RTD是低成本的检测方案,适用于检测精度不高、导线长度较短的场合。

只要思想不滑坡,想法总比问题多。 4261

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

古诗词生成API终极指南:三步快速上手AI诗词创作

一言·古诗词 API 是一个可以随机返回一句古诗词名句的接口,采用 Vert.x + Redis 全异步开发,确保毫秒级稳定响应。无论是开发诗词类应用、增添产品文化气息,还是学习API集成,这个工具都能满足你的需求。 ## 一、API核心优势:为何选择一言·古诗词接口? ### 1.1 毫秒级响应,性能卓越 基于 Vert.x Java 全异步框架和 Redis 数据库构建,保证了接口的高效稳

gitblog_00891的博客 495

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

玩着背诗秒会上瘾!这款AI神器让娃疯狂迷恋古诗词

在AI时代,编程不再是高不可攀的技能,只要你有创意,AI就能帮你实现。无论是开发应用、设计网站,还是分析数据,你只需用自然语言描述想法,AI工具就能生成代码、优化逻辑,甚至调试错误,让技术门槛大幅降低。未来的创新者不一定是专业程序员,但一定是善于利用AI将灵感转化为现实的人。现在,只要敢想,人人都能成为“编程高手”,用AI把创意变成触手可及的产品。

2403_88996352的博客 843

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

免费的api接口

欢迎大家加群讨论:地址:https://www.apiopen.top 为了方便各类开发者,现提供免费开放Api接口,所有接口均无使用限制,返回格式全是JSON,所以基本能满足大家的开发需求,但请各位不要将这些Api接入正式项目,因为有一些不稳定因素,目前服务器购买时长是三年,如果到期,我会自动续费,这些Api是我平时业余时间编写,可能有些不能满足需求的情况,请大家在留言区提出...

weixin_30653023的博客 592

诗泉:用 Go 封装 40 万首古诗词,一行 Docker 命令即可私有部署的 REST/GraphQL API 服务

三个信源均认同原文的基本描述,没有实质性反驳,但也没有提供独立性能基准测试。GPL-3.0 与数据量口径是两个值得独立验证的细节。

星核AI实验室 269

2020年最新小说免费API接口干货

目前接口列表: 快递查询:https://api.apiopen.top/EmailSearch?number=1012002 随机单句诗词推荐:https://api.apiopen.top/singlePoetry 随机一首诗词推荐:https://api.apiopen.top/recommendPoetry 搜索古诗词:https://api.apiopen.top/searchPoetry?name=古风二首二 搜索古诗词作者:https://api.apiopen.top/searc.

shengguimin的博客 7179
上一篇: 古诗词·一言 API:一句诗的接口
下一篇: MockServer:把 mock 和 proxy 揉到一个端口里
普通网友
博客等级 码龄150天 0粉丝 16原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值