星梦一言 API 调用文档
欢迎使用星梦平台提供的高性能一言 (Hitokoto) 接口。本接口支持多种参数过滤，极速响应，支持跨域调用。
基础信息
- 接口地址：
http://api.xmc.tw/yiyan/ - 请求方式：
GET - 默认返回格式：
JSON
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
type | String | 否 | 无 | 按文案类型获取，例如：emo, anime, philosophy, movie。不带此参数则全站随机。 |
word | String | 否 | 无 | 限制返回句子的字数。 - 填 15 表示最大不超过 15 字。- 填 10-20 表示返回 10 到 20 字之间的句子。 |
format | String | 否 | json | 返回格式。 - 不填 或 json：返回完整结构化化数据。- 填 text：直接返回纯文本一言（适合给各种脚本直接使用）。 |
action | String | 否 | 无 | 参数填为 total 时，返回该站所有一言字数与历史总调用次数。 |
调用示例
1. 基础调用 (随机一条)
请求：
text
GET http://api.xmc.tw/yiyan/