诗词

一言（随机/每日/场景/此刻）

0次调用

1 积分/次

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

GET

uapis.cn

/api/v1/saying/random

查询参数

mode

string

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

scene

string

推荐场景。当 mode=recommend 时必填，例如 night、morning、work 等。请从中选择。

source

string

语料来源过滤。支持重复传参，或使用逗号/分号分隔多个值。请从中选择。

四种模式（`mode`）

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

语言控制

语料分中英文两类，可通过 source 或 category 控制：

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

使用须知

小贴士

source、category、tag 支持多值，用英文逗号 , 或分号 ; 分隔。
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可选

标签过滤。支持重复传参，或使用逗号/分号分隔多个值。请从中选择。

名称	类型	属性	说明
`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

{
  // 语录唯一标识。
  "uuid": "dfs-5d3627b262f01db19ddf29d0c8d94828",
  // 语录正文。
  "content": "无论多么微小的邂逅，都必定有着某种意义。",
  // 语录出处或来源。
  "source": "夏目友人帐",
  // 作者或说话者。
  "author": "绿川幸",
  // 作者扩展信息，部分语料返回。
  "authorinfo": {
    "id": "natsume",
    "name": "绿川幸",
    "description": "漫画作者",
    "bio": "代表作包括《夏目友人帐》。",
    "link": "https://example.com/author/natsume"
  },
  // 所属语料库标识。
  "corpus": "sentences-bundle",
  // 语录分类。
  "category": "动画",
  // 命中的标签，部分模式返回。
  "matchedTags": [
    "string"
  ],
  // 语料入库时间戳（秒），部分语料返回。
  "createdAt": "1675500151",
  // 正文字数。
  "contentLength": 21
}

格式 2每日 / 场景 / 此刻模式 (daily / recommend / moment)

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

JSON

{
  // 当前运行模式。
  "mode": "daily",
  // 仅 daily 模式返回，对应日期，格式 YYYY-MM-DD。
  "date": "2026-06-25",
  // 仅 recommend 模式返回，命中的场景画像。
  "scene": {
    "key": "night",
    "name": "夜晚",
    "description": "偏思考、回味、轻情绪化的语料"
  },
  // 仅 moment 模式返回，命中的时段标识。
  "timeSegment": "noon",
  // 仅 moment 模式返回，服务器当前时间，ISO 8601 格式。
  "currentTime": "2026-06-25T13:57:33+08:00",
  // 当次结果的确定性种子。
  "seed": "daily20260625-",
  // 语录本体。
  "item": {
    // 语录唯一标识。
    "uuid": "dfs-5d3627b262f01db19ddf29d0c8d94828",
    // 语录正文。
    "content": "无论多么微小的邂逅，都必定有着某种意义。",
    // 语录出处或来源。
    "source": "夏目友人帐",
    // 作者或说话者。
    "author": "绿川幸",
    // 作者扩展信息，部分语料返回。
    "authorinfo": {
      "id": "natsume",
      "name": "绿川幸",
      "description": "漫画作者",
      "bio": "代表作包括《夏目友人帐》。",
      "link": "https://example.com/author/natsume"
    },
    // 所属语料库标识。
    "corpus": "sentences-bundle",
    // 语录分类。
    "category": "动画",
    // 命中的标签，部分模式返回。
    "matchedTags": [
      "string"
    ],
    // 语料入库时间戳（秒），部分语料返回。
    "createdAt": "1675500151",
    // 正文字数。
    "contentLength": 21
  }
}

400 / 错误的请求

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

JSON

{
  "code": "INVALID_PARAMETER",
  "message": "invalid saying scene"
}

404 / 未找到

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

JSON

{
  "code": "NOT_FOUND",
  "message": "no saying matched current query"
}

快速上手

选择你的语言查看调用示例

认证方式：

cURL 命令

curl 'https://uapis.cn/api/v1/saying/random'

常见问题解答