古诗词·一言 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

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

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

gitblog_00088的博客 1121

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

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

APIsmileJ的博客 422

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

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

gitblog_00214的博客 493

一行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 vs 今日诗词API:开源与商业版功能对比

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

gitblog_00336的博客 404

基于斜坡补偿的Buck电路峰值电流+电压电流双闭环控制【附说明文档】(Simulink仿真实现)优快云首页发布文章优快云同步助手LLC谐振变换器开环+闭环软启动仿真设计(Simulink

内容概要:本文围绕三电平VIENNA整流器的双闭环控制与中点电位平衡问题展开仿真研究,提出了一种基于上下电容电压差值补偿的中点电位平衡策略。该策略在传统电压电流双闭环PI控制的基础上,引入电容电压差值作为反馈信号,通过SVPWM调制中冗余小矢量的时间分配实现中点电荷的定向调节,从而在不改变主控制结构的前提下有效抑制中点电位偏差。仿真结果表明,该方法不仅确保直流母线电压稳定跟踪800V给定值,还能显著提升上下电容电压的均衡度,同时保持输入电流低谐波水平,验证了控制策略的可行性和有效性。; 适合人群:电力电子、电气自动化及相关专业的研究生、科研人员及工程技术人员,具备一定的MATLAB/Simulink仿真基础和电力电子拓扑知识背景者更佳。; 使用场景及目标:①掌握三电平VIENNA整流器的工作原理与中点电位波动的成因;②理解电压电流双闭环PI控制的设计要点与参数整定原则;③学习基于差值补偿的中点电位平衡控制策略及其与SVPWM的协同机制;④应用于充电桩、航空电源、通信电源等中大功率单向整流场合的控制系统设计与优化。; 阅读建议:建议结合文中提供的仿真模型与参数设置进行动手实践,重点关注中点电位平衡投入前后电容电压波形的变化,对比分析不同工况下的系统动态响应,深入理解控制策略的作用机理。同时可进一步探索在电网不平衡、轻载等复杂工况下的控制性能,以拓展应用场景。

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

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

cloudYun的博客 2306

ESD 防护深度解析:模型、等级、系统设计与防护策略

本文系统阐述了静电放电(ESD)防护的核心技术体系。首先对比分析了HBM(人体模型)和CDM(充电设备模型)两种基础ESD模型的物理特性、测试标准及分级要求,指出相同电压下CDM的破坏性是HBM的15-20倍。其次详细解析了IEC61000-4-2系统级ESD标准,包括接触/空气放电测试方法及判定等级。重点提出了系统级防护的三层架构:空间隔离(≥10mm间距)、电气隔离(地平面分割)和TVS管选型(响应时间<1ns),并对比了MOV、SCR等防护器件特性。针对不同应用场景(消费电子、工业控制等)给出了差异化

bother3000的博客 1890

AVS3代码阅读HPM4.0

参考AVS3代码阅读(HPM6.0)(一.整体架构以及CU划分部分代码) 版本:HPM4.0 核心文件:app_encoder.c   要做的是帧间预测,所以前面的函数先暂时不管了,挖个坑以后再填。直接从enc_pic看起。 enc_pic()    ...

CRR的博客 3189

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

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

gitblog_01100的博客 1194

疫情数据分析的“核武器”!JHU CSSE COVID-19数据集超深度解析与实战指南(附代码)

在面对这场没有硝烟的战争时,除了医护人员在前线与病毒搏斗,还有一群默默的英雄——数据科学家和分析师,他们利用手中的“数据武器”,昼夜不停地监测、分析、预测疫情走势,为政府决策、资源调配、公众科普提供了至关重要的支撑。同时,由于某些国家(如美国、加拿大、澳大利亚、中国等)的数据细化到省/州级别,为了得到国家层面的总数据,我们需要按国家和日期进行聚合。正是在这样的背景下,经过这些步骤,我们已经得到了一个包含了累计数据、每日新增数据和活跃病例数的完整数据集,可以开始进行深入的分析和可视化了!

wylee的博客 1167

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

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

gitblog_00020的博客 89

【IIC通信】Chap.1(I2C)IIC通信原理、IIC读写时序详解

IIC通信以两根连线SDA、SCL实现了完善的全双工同步数据传送, 可以方便地构成多机系统和外围器件扩展系统。

Jie_MSD的博客 2万+

Win32逆向必备:X32dbg中窗口句柄查看与消息断点的高级用法

本文深入探讨了X32dbg在Win32逆向工程中的高级应用,重点解析窗口句柄查看与消息断点的实战技巧。通过MFC程序逆向案例,详细介绍了如何利用窗口句柄层次结构、条件断点设置及消息映射表定位等技术,快速捕获关键业务逻辑,提升逆向分析效率。

nginx7reverse的博客 1017

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

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

Roufsi的博客 785

地平线旭日X3 安装xfce桌面+VNC查看USB摄像头

VNC是Virtual Network Computing的缩写,它是一种使用RFB(Remote Frame Buffer)协议的用于控制远程电脑的图形桌面分享系统。xfce桌面相比于GNOME桌面更加轻量,占用的资源更少,在没有GPU的设备上也可以运行(旭日的Desktop版本从外观上好像就是xfce桌面,具体没有尝试)。可以使用专用的VNC客户端连接到开发板,例如vnc viewer。板子默认带有openssh-server,因此,WiFi热点连接成功后,就可以使用ssh登录开发板了。

bingdund的博客 510

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

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

gitblog_00891的博客 495

OpenClaw用户必看:每天0成本使用OpenClaw!NVIDIA NIM免费大模型接入教程

🚀 OpenClaw接入NVIDIA NIM免费API!glm5、minimax-m2.5等大量模型任选,0成本升级AI助手!💰

XiaoqiangClub的博客 5580

[Dify实战] 在 Dify 官网环境使用 File Translator 插件实现 Office 文档翻译(支持 DOCX/XLSX/PPTX)

摘要:Dify平台的FileTranslator插件可实现Office文档一键翻译,保留原格式和结构。该插件支持Word、Excel、PPT等文件格式,无需额外密钥,直接复用Dify配置的大模型。安装后,用户可在Workflow中调用插件,设置目标语言等参数完成翻译。输出文件自动命名,保留原格式。适用于跨国协作、海外营销等场景,显著提升多语言办公效率。该插件简化了文档翻译流程,是企业用户和开发者的实用工具。

技术小甜甜:传播可落地技术,帮助个人和企业降低解决真实场景问题的成本 544

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

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

2403_88996352的博客 843

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

免费的api接口

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

weixin_30653023的博客 592

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

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

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

星核AI实验室 269

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

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
上一篇: GBrain:给你的 AI Agent 加一个大脑
下一篇: 古诗词·一言 API:一句诗的接口
普通网友
博客等级 码龄151天 0粉丝 16原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值