诗词

一言(随机/每日/场景/此刻)

0次调用
1 积分/次

一言接口,返回一条随机语录。通过 mode 参数切换四种返回方式,并支持按来源、分类、标签过滤。

四种模式(mode

  • random(默认):每次调用随机返回一条语录。
  • daily:同一天内返回固定的同一条,适合每日打卡、签到等场景。
  • recommend:配合 scene 参数,返回指定场景(如 nightmorning)的语录。
  • moment:根据请求时所处时段,自动返回应景语录。

语言控制

语料分中英文两类,可通过 sourcecategory 控制:

  • 需要中文:source 选「综合句子语料库 / 曹星宇句子集」,或 category 选中文分类(如 影视、文学、诗词)。
  • 需要英文:source 选「Quotable / 英文历史名言」。

使用须知

小贴士
  • sourcecategorytag 支持多值,用英文逗号 , 或分号 ; 分隔。
  • scene 仅在 mode=recommend 时生效且必填,其他模式下会被忽略。
  • 请求示例:
    • 随机:GET /api/v1/saying/random
    • 每日:GET /api/v1/saying/random?mode=daily
    • 场景:GET /api/v1/saying/random?mode=recommend&scene=night
    • 此刻:GET /api/v1/saying/random?mode=moment

查询参数

mode
string可选

运行模式。不传或 random 为随机一言;可选 daily、recommend、moment。

scene
string可选
推荐场景。当 mode=recommend 时必填,例如 night、morning、work 等。请从中选择。
source
string可选
语料来源过滤。支持重复传参,或使用逗号/分号分隔多个值。请从中选择。
category
string可选
分类过滤。支持重复传参,或使用逗号/分号分隔多个值。请从中选择。
tag
string可选
标签过滤。支持重复传参,或使用逗号/分号分隔多个值。请从中选择。

响应

200 / 请求成功

请求成功。random 模式直接返回语录对象;daily / recommend / moment 模式返回带模式信息的包装对象,语录本体在 item 字段中。

格式 1随机模式 (random)
JSON
格式 2每日 / 场景 / 此刻模式 (daily / recommend / moment)

包装对象。外层字段随 mode 不同而不同,语录本体统一放在 item 中。

JSON

400 / 错误的请求

参数无效。通常是由于指定的推荐场景不存在,或者过滤参数格式有误。

JSON

404 / 未找到

未找到满足当前过滤条件的语录数据。

JSON