穿梭千年诗海,邂逅文字瑰宝!本诗词资源接口汇聚 4000 余首经典诗词,从李杜豪情到柳永婉约,从唐诗宋词到元曲佳作,全方位收录。不仅能获取诗词全文,还提供深度解读服务:精准的诗词释义,带你领会作品核心意境;细致的逐句解析,剖析诗人创作巧思;详尽的字词注释,扫清阅读障碍。更有专业配音生成的诗词音频,声情并茂诵读经典,助力打造沉浸式诗词体验。无论是开发诗词学习 APP、文化类小程序,还是搭建在线诗词鉴赏平台,该接口都能满足需求,让用户在平仄韵律间感受中华传统文化的无穷魅力。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| msg | string | 是 | 诗词搜索内容,如:赠汪伦 | 赠汪伦 |
| n | string | 否 | 需要选择的序号,如:1 | 1 |
[
{
"name": "msg",
"type": "string",
"required": true,
"description": "诗词搜索内容,如:赠汪伦",
"example": "赠汪伦"
},
{
"name": "n",
"type": "string",
"required": false,
"description": "需要选择的序号,如:1",
"example": "1"
}
]
{"openapi":"3.1.1","info":{"title":"诗词","description":"穿梭千年诗海,邂逅文字瑰宝!本诗词资源接口汇聚 4000 余首经典诗词,从李杜豪情到柳永婉约,从唐诗宋词到元曲佳作,全方位收录。不仅能获取诗词全文,还提供深度解读服务:精准的诗词释义,带你领会作品核心意境;细致的逐句解析,剖析诗人创作巧思;详尽的字词注释,扫清阅读障碍。更有专业配音生成的诗词音频,声情并茂诵读经典,助力打造沉浸式诗词体验。无论是开发诗词学习 APP、文化类小程序,还是搭建在线诗词鉴赏平台,该接口都能满足需求,让用户在平仄韵律间感受中华传统文化的无穷魅力。","version":"1.0.0"},"paths":{"/v1/shici.php":{"get":{"summary":"诗词","description":"穿梭千年诗海,邂逅文字瑰宝!本诗词资源接口汇聚 4000 余首经典诗词,从李杜豪情到柳永婉约,从唐诗宋词到元曲佳作,全方位收录。不仅能获取诗词全文,还提供深度解读服务:精准的诗词释义,带你领会作品核心意境;细致的逐句解析,剖析诗人创作巧思;详尽的字词注释,扫清阅读障碍。更有专业配音生成的诗词音频,声情并茂诵读经典,助力打造沉浸式诗词体验。无论是开发诗词学习 APP、文化类小程序,还是搭建在线诗词鉴赏平台,该接口都能满足需求,让用户在平仄韵律间感受中华传统文化的无穷魅力。","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"赠汪伦"},"description":"诗词搜索内容,如:赠汪伦"},{"name":"n","in":"query","required":false,"schema":{"type":"string","example":"1"},"description":"需要选择的序号,如:1"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"诗词","description":"穿梭千年诗海,邂逅文字瑰宝!本诗词资源接口汇聚 4000 余首经典诗词,从李杜豪情到柳永婉约,从唐诗宋词到元曲佳作,全方位收录。不仅能获取诗词全文,还提供深度解读服务:精准的诗词释义,带你领会作品核心意境;细致的逐句解析,剖析诗人创作巧思;详尽的字词注释,扫清阅读障碍。更有专业配音生成的诗词音频,声情并茂诵读经典,助力打造沉浸式诗词体验。无论是开发诗词学习 APP、文化类小程序,还是搭建在线诗词鉴赏平台,该接口都能满足需求,让用户在平仄韵律间感受中华传统文化的无穷魅力。","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"赠汪伦"},"description":"诗词搜索内容,如:赠汪伦"},{"name":"n","in":"query","required":false,"schema":{"type":"string","example":"1"},"description":"需要选择的序号,如:1"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"title": "赠汪伦",
"author": {
"name": "李白",
"birth": "701年",
"death": "762年",
"aliasname": [
"李白(701~762)",
"青莲居士",
"李书豪",
"李太白",
"诗仙"
],
"representative": [
"静夜思",
"蜀道难",
"望庐山瀑布",
"月下独酌"
],
"description": [
"李白(701-762),字太白,号青莲居士,唐朝浪漫主义诗人,被后人誉为“诗仙”。汉族,祖籍陇西成纪,出生于碎叶城(当时属唐朝领土,今属吉尔吉斯斯坦),4岁再随父迁至剑南道绵州。李白存世诗文千余篇,有《李太白集》传世。762年病逝,享年61岁。其墓在今安徽当涂,四川江油、湖北安陆有纪念馆。李白生活在盛唐时期,二十五岁时只身出蜀,开始了广泛漫游生活,南到洞庭湘江,东至吴、越,寓居在安陆、应山。直到天宝元年(742),因道士吴筠的推荐,李白被召至长安,供奉翰林,后因不能见容于权贵,在京仅两年半,就赐金放还而去,然后飘荡四方的漫游生活。李白和杜甫并称“李杜”。他的诗歌既反映了时代的繁荣景象,也揭露了统治阶级的荒淫和腐败,表现出蔑视权贵,反抗传统束缚,追求自由和理想的积极精神。"
],
"state": [
"中国"
],
"nation": [
"汉族"
],
"img": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/author.jpg",
"more": [
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/0.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/1.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/2.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/3.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/4.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/5.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/6.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/7.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/8.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/9.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/10.jpg",
"https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/11.jpg"
]
},
"content": "李白乘舟将欲行,忽闻岸上踏歌声。\\n桃花潭水深千尺,不及汪伦送我情。",
"voice": {
"woman": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/woman.mp3",
"second_know": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/second_know.mp3",
"man": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/man.mp3"
},
"notes": "我正乘上小船,刚要解缆出发,忽听岸上传来,悠扬踏歌之声。看那桃花潭水,纵然深有千尺,怎能及汪伦送我之情。",
"shiju_interpretation": [
{
"body": "李白乘舟将欲行",
"pinyin": "lǐ bái chéng zhōu jiāng yù xíng",
"translate": "我正乘上小船,刚要解缆出发,"
},
{
"body": "忽闻岸上踏歌声",
"pinyin": "hū wén àn shàng tà gē shēng",
"translate": "忽听岸上传来,悠扬踏歌之声。"
},
{
"body": "桃花潭水深千尺",
"pinyin": "táo huā tán shuǐ shēn qiān chǐ",
"translate": "看那桃花潭水,纵然深有千尺,"
},
{
"body": "不及汪伦送我情",
"pinyin": "bù jí wāng lún sòng wǒ qíng",
"translate": "怎能及汪伦送我之情。"
}
],
"ciyu_explanation": [
{
"zhushi": "李白的朋友。",
"source": "汪伦"
},
{
"zhushi": "原为汉、唐时的风俗性歌舞,参与者手搀手以脚踏地而歌。唱歌时以脚踏地为节奏,参加者围成圆圈或排列成行,互相牵手,边歌边舞。",
"source": "踏歌"
},
{
"zhushi": "在今安徽泾县西南一百里。《一统志》谓其深不可测。",
"source": "桃花潭"
},
{
"zhushi": "人用潭水深千尺比喻汪伦与他的友情,运用了夸张的手法(潭深千尺不是实有其事)。",
"source": "深千尺"
},
{
"zhushi": "不如。",
"source": "不及"
}
],
"dynasty": "唐",
"tags": [
"小学古诗",
"友情",
"写水",
"人物",
"情感",
"送别",
"离别",
"写人",
"场景",
"景色",
"数字"
],
"type": [
"诗",
"古代诗"
]
}
本接口提供经典诗词检索与鉴赏服务,覆盖唐诗宋词元曲等 4000 余首作品,支持诗词原文、逐句解析、字词注释及专业配音音频获取。适用于诗词学习类应用、文化小程序及在线鉴赏平台开发。
/v1/shici.php
GET、POST
无需密钥。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| msg | string | 是 | 诗词搜索内容,支持诗词名称、诗句片段等检索词,如输入“赠汪伦”可查询李白该诗 |
| n | string | 否 | 当检索结果存在多条时,传入此参数指定返回结果的序号,从 1 开始编号,如传入 1 则返回第一条匹配结果 |
{
"code": 200,
"title": "赠汪伦",
"author": {
"name": "李白",
"birth": "701年",
"death": "762年",
"aliasname": ["李白(701~762)", "青莲居士", "李书豪", "李太白", "诗仙"],
"representative": ["静夜思", "蜀道难", "望庐山瀑布", "月下独酌"],
"description": ["李白(701-762),字太白,号青莲居士,唐朝浪漫主义诗人,被后人誉为“诗仙”。..."],
"state": ["中国"],
"nation": ["汉族"],
"img": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/author.jpg",
"more": ["https://xiaoapi.cn/v1/data/gushi/e69d8ee799bd/0.jpg", "..."]
},
"content": "李白乘舟将欲行,忽闻岸上踏歌声。\n桃花潭水深千尺,不及汪伦送我情。",
"voice": {
"woman": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/woman.mp3",
"second_know": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/second_know.mp3",
"man": "https://xiaoapi.cn/v1/data/gushi/d74b57ecdfae47b49f950af7a4ed7d57/man.mp3"
},
"notes": "我正乘上小船,刚要解缆出发,忽听岸上传来,悠扬踏歌之声。...",
"shiju_interpretation": [
{
"body": "李白乘舟将欲行",
"pinyin": "lǐ bái chéng zhōu jiāng yù xíng",
"translate": "我正乘上小船,刚要解缆出发,"
}
],
"ciyu_explanation": [
{
"source": "汪伦",
"zhushi": "李白的朋友。"
}
],
"dynasty": "唐",
"tags": ["小学古诗", "友情", "写水", "送别"],
"type": ["诗", "古代诗"]
}
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| title | string | 诗词标题 |
| dynasty | string | 所属朝代,如“唐”“宋” |
| content | string | 诗词正文,句间以换行符分隔 |
| notes | string | 诗词整体释义 |
| author | object | 作者信息对象,详见下方子字段 |
| voice | object | 诗词音频地址,含 woman(女声)、man(男声)、second_know(再读一遍)等发音资源 |
| shiju_interpretation | array | 逐句解析列表,每项对应一句诗的解读 |
| ciyu_explanation | array | 字词注释列表,详解诗中关键词语 |
| tags | array | 诗词标签数组,如“送别”“友情”等 |
| type | array | 诗词类型,如“诗”“词”“曲”或“古代诗”等 |
author 子对象字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| name | string | 作者姓名 |
| birth | string | 生年 |
| death | string | 卒年 |
| aliasname | array | 别号别名列表 |
| representative | array | 代表作品列表 |
| description | array | 作者生平描述 |
| state | array | 国籍或所属地区 |
| nation | array | 民族信息 |
| img | string | 作者头像图片地址 |
| more | array | 相关图片资源列表 |
shiju_interpretation 子对象字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| body | string | 诗句原文 |
| pinyin | string | 诗句拼音 |
| translate | string | 诗句白话翻译 |
ciyu_explanation 子对象字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| source | string | 词语或词汇 |
| zhushi | string | 对应词语的详细注释 |
调用失败时,接口将返回包含错误信息的 JSON 响应,示例如下:
{
"code": 0,
"msg": "请求过于频繁,请稍后重试",
"errcode": 11005
}
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
curl "https://xiaoapi.cn/v1/shici.php?msg=赠汪伦"
// PHP
$msg = "赠汪伦";
$url = "https://xiaoapi.cn/v1/shici.php?msg=" . urlencode($msg);
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data['title'] . "\n";
echo $data['content'] . "\n";
msg 参数为必填项,用于指定诗词名称或关键词进行搜索,建议使用准确的诗词标题以获得最佳匹配结果。n 参数可选传入,用于指定目标序号以筛选具体诗词,序号从 1 开始计数。voice 包含多个配音音频链接,可根据业务需求选用女声、男声或二度创作等不同版本。author 中的 more 字段包含作者相关图片资源链接,建议做好本地缓存以提升用户体验。shiju_interpretation 提供逐句解析,含拼音与释义,ciyu_explanation 提供字词注释,两者可结合使用构建完整的诗词学习功能。curl "https://xiaoapi.cn/v1/shici.php?msg=赠汪伦"
// 结果将在此处显示