接口信息

GET,POST https://api.xunjinlu.fun/api/yiyan/aword.php

请求方法

GET,POST

所属分类

一言文案

每分钟限流

不限速

调用次数

6,554

访问鉴权

密钥可选

需要积分

免费

提交时间

2026-03-11 02:46:59

贡献者

尋鯨錄

接口检测

检测接口是否正常响应

接口反馈

如果接口调用出现问题，请在此反馈（* 联系方式为必填项，建议填写QQ号以便联系）

免责声明

使用本平台接口即表示同意本声明。

1. 数据来源：接口数据来自第三方公开网络或用户上传，本平台不保证准确性、完整性、实时性，请以官方信息为准。
2. 合法性与安全性：本平台无法核实每个接口的安全性、合法性，使用者自行承担相关风险。
3. 用途限制：标注“学习专用”的接口禁止商用；严禁用于违法违规行为（如诈骗、赌博、侵权等）。违规后果由使用者自行承担。
4. 损害免责：使用本接口产生的任何直接或间接损失，本平台不承担责任。
5. 第三方上传：用户/商户上传的接口若侵权或违法，由上传者承担全部责任。
6. 监督配合：本平台依法记录访问日志，如发现违法活动将配合执法部门处理，并有权随时限制或封禁服务。
注:本平台保留最终解释权，并可能随时更新本声明。

请求参数

                            
                                        参数名
                                        类型
                                        必填
                                        描述
                                    
                                        key
                                        string
                                        
                                                                                        否
                                                                                    
                                        平台 API 访问密钥（选填）
                                    
                                        c
                                        string
                                        
                                                                                        否
                                                                                    
                                        句子类型：a动画 b漫画 c游戏 d文学 e原创 f网络 g其他 h影视 i诗词 j网易云 k哲学 l抖机灵，支持多选如c=a&c=h
                                    
                                        encode
                                        string
                                        
                                                                                        否
                                                                                    
                                        返回编码：json(默认) text(纯文本) js(JavaScript)
                                    
                                        charset
                                        string
                                        
                                                                                        否
                                                                                    
                                        字符集：utf-8(默认) gbk
                                    
                                        callback
                                        string
                                        
                                                                                        否
                                                                                    
                                        异步回调函数名，配合encode=js实现JSONP跨域
                                    
                                        select
                                        string
                                        
                                                                                        否
                                                                                    
                                        CSS选择器，配合encode=js自动填充页面元素，默认.hitokoto
                                    
                                        min_length
                                        integer
                                        
                                                                                        否
                                                                                    
                                        返回句子的最小长度（包含），默认0
                                    
                                        max_length
                                        integer
                                        
                                                                                        否
                                                                                    
                                        返回句子的最大长度（包含），默认30

[
    {
        "name": "key",
        "type": "string",
        "required": false,
        "description": "平台 API 访问密钥（选填）",
        "example": "sk_xxxxxxxxxxxxxxxx"
    },
    {
        "name": "c",
        "type": "string",
        "required": false,
        "description": "句子类型：a动画 b漫画 c游戏 d文学 e原创 f网络 g其他 h影视 i诗词 j网易云 k哲学 l抖机灵，支持多选如c=a&c=h",
        "example": ""
    },
    {
        "name": "encode",
        "type": "string",
        "required": false,
        "description": "返回编码：json(默认) text(纯文本) js(JavaScript)",
        "example": ""
    },
    {
        "name": "charset",
        "type": "string",
        "required": false,
        "description": "字符集：utf-8(默认) gbk",
        "example": ""
    },
    {
        "name": "callback",
        "type": "string",
        "required": false,
        "description": "异步回调函数名，配合encode=js实现JSONP跨域",
        "example": ""
    },
    {
        "name": "select",
        "type": "string",
        "required": false,
        "description": "CSS选择器，配合encode=js自动填充页面元素，默认.hitokoto",
        "example": ""
    },
    {
        "name": "min_length",
        "type": "integer",
        "required": false,
        "description": "返回句子的最小长度（包含），默认0",
        "example": ""
    },
    {
        "name": "max_length",
        "type": "integer",
        "required": false,
        "description": "返回句子的最大长度（包含），默认30",
        "example": ""
    }
]

响应示例

// 标准JSON响应
{
    "id": 5824,
    "uuid": "dd470e3e-2c28-4f66-9f81-5f6c71e1900f",
    "hitokoto": "我命由我不由天，是魔是仙，我是谁只有我自己说了算。",
    "type": "h",
    "from": "哪吒之魔童降世",
    "from_who": "饺子",
    "creator": "admin",
    "creator_uid": 1,
    "reviewer": 1,
    "commit_from": "web",
    "created_at": 1563862367,
    "length": 26
}

// 纯文本响应（encode=text）
我命由我不由天，是魔是仙，我是谁只有我自己说了算。

// JS同步调用响应（encode=js）
(function(){
    var elements = document.querySelectorAll(".hitokoto");
    for(var i=0; i<elements.length; i++){
        elements[i].innerHTML = "我命由我不由天，是魔是仙，我是谁只有我自己说了算。";
    }
})();

// JS异步回调响应（encode=js&callback=moe）
moe({
    "id": 5824,
    "uuid": "dd470e3e-2c28-4f66-9f81-5f6c71e1900f",
    "hitokoto": "我命由我不由天，是魔是仙，我是谁只有我自己说了算。",
    "type": "h",
    "from": "哪吒之魔童降世",
    "from_who": "饺子",
    "creator": "admin",
    "creator_uid": 1,
    "reviewer": 1,
    "commit_from": "web",
    "created_at": 1563862367,
    "length": 26
});

详细文档

## API描述一言（Hitokoto）语句接口，提供随机优美句子获取服务。支持按类型筛选、长度控制、多种返回格式，适用于网站签名栏、APP启动页、博客装饰等场景。本接口完全兼容一言官方API规范。 ## 详细文档 ### 接口地址 ``` https://api.xunjinlu.fun/api/yiyan/aword.php ``` ### 请求方式 GET / POST ### 句子类型 | 参数 | 说明 | |-----|------| | a | 动画 | | b | 漫画 | | c | 游戏 | | d | 文学...

AI文档 AI生成

> **由 AI 生成**：本文档根据接口配置自动生成，仅供参考，具体以实际接口返回为准。 --- ### 接口简介随机一言·网络接口提供优美句子随机获取服务，支持按类型筛选、长度控制及多种返回格式。适用于网站签名栏、APP启动页、博客装饰等场景。接口使用网络数据源，若需更快响应可切换至本地数据的V1接口。调用无需鉴权。 --- ### 请求说明 - **请求地址**：`https://api.xunjinlu.fun/api/yiyan/aword.php` - **HTTP方法**：`GET` / `POST` - **常用请求头**： - `Accept: application/json`（默认） - `Accept: text/plain`（纯文本格式） - `Accept: application/javascript`（JS格式） --- ### 请求参数表 | 参数名 | 类型 | 必填 | 说明 ...

> **由 AI 生成**：本文档根据接口配置自动生成，仅供参考，具体以实际接口返回为准。 --- ### 接口简介随机一言·网络接口提供优美句子随机获取服务，支持按类型筛选、长度控制及多种返回格式。适用于网站签名栏、APP启动页、博客装饰等场景。接口使用网络数据源，若需更快响应可切换至本地数据的V1接口。调用无需鉴权。 --- ### 请求说明 - **请求地址**：`https://api.xunjinlu.fun/api/yiyan/aword.php` - **HTTP方法**：`GET` / `POST` - **常用请求头**： - `Accept: application/json`（默认） - `Accept: text/plain`（纯文本格式） - `Accept: application/javascript`（JS格式） --- ### 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |--------------|----------|------|----------------------------------------------------------------------| | `c` | string | 否 | 句子类型：a动画/b漫画/c游戏/d文学/e原创/f网络/g其他/h影视/i诗词/j网易云/k哲学/l抖机灵，支持多选（如 `c=a&c=h`） | | `encode` | string | 否 | 返回编码：`json`（默认）\|`text`（纯文本）\|`js`（JavaScript） | | `charset` | string | 否 | 字符集：`utf-8`（默认）\|`gbk` | | `callback` | string | 否 | 异步回调函数名（需配合 `encode=js` 实现JSONP跨域） | | `select` | string | 否 | CSS选择器（配合 `encode=js` 自动填充页面元素，默认 `.hitokoto`） | | `min_length` | integer | 否 | 返回句子的最小长度（包含），默认 `0` | | `max_length` | integer | 否 | 返回句子的最大长度（包含），默认 `30` | --- ### 返回字段表（JSON格式） | 字段名 | 类型 | 说明 | |--------------|----------|----------------------------------------------------------------------| | `id` | integer | 句子唯一ID | | `uuid` | string | 句子UUID | | `hitokoto` | string | 一言内容 | | `type` | string | 句子类型（对应请求参数 `c` 的选项） | | `from` | string | 出处（如作品/来源名称） | | `from_who` | string | 作者/创作者 | | `creator` | string | 提交者用户名 | | `creator_uid`| integer | 提交者用户ID | | `reviewer` | integer | 审核者ID | | `commit_from`| string | 提交来源（如 `web`） | | `created_at` | integer | 创建时间戳 | | `length` | integer | 句子长度（字符数） | --- ### 返回JSON示例 #### 成功响应（JSON） ```json { "id": 5824, "uuid": "dd470e3e-2c28-4f66-9f81-5f6c71e1900f", "hitokoto": "我命由我不由天，是魔是仙，我是谁只有我自己说了算。", "type": "h", "from": "哪吒之魔童降世", "from_who": "饺子", ... } ``` #### 失败响应（JSON） ```json { "error": "Invalid parameter", "message": "Unsupported encode type" } ``` --- ### 错误与状态 - **常见HTTP状态码**： - `200 OK`：请求成功 - `400 Bad Request`：参数错误（如无效的 `encode` 值） - **业务错误**：以实际返回的 `message` 字段为准（如 `"Invalid parameter"`）。 --- ### 调用示例 #### 直接访问 ```url https://api.xunjinlu.fun/api/yiyan/aword.php?c=h&encode=json ``` 获取影视类句子并返回JSON格式。 #### cURL ```bash curl -X GET "https://api.xunjinlu.fun/api/yiyan/aword.php?c=i&encode=text" -H "Accept: text/plain" ``` 获取诗词类句子并以纯文本返回。 #### Python requests ```python import requests url = "https://api.xunjinlu.fun/api/yiyan/aword.php" params = { "c": "a", # 动画类型 "min_length": 10, # 最小长度10字符 "max_length": 20 # 最大长度20字符 } response = requests.get(url, params=params) print(response.json()["hitokoto"]) ``` #### PHP ```php "j", # 网易云音乐 "encode" => "js", # JavaScript格式 "callback" => "moe" # 回调函数名 ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url . "?" . http_build_query($params)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $result = curl_exec($ch); curl_close($ch); echo $result; ?> ``` #### HTML ```html

```

查看完整文档 →

在线测试

接口地址

https://api.xunjinlu.fun/api/yiyan/aword.php

请求方式

GET POST

// 请求参数

key - 平台 API 访问密钥（选填）

c - 句子类型：a动画 b漫画 c游戏 d文学 e原创 f网络 g其他 h影视 i诗词 j网易云 k哲学 l抖机灵，支持多选如c=a&c=h

encode - 返回编码：json(默认) text(纯文本) js(JavaScript)

charset - 字符集：utf-8(默认) gbk

callback - 异步回调函数名，配合encode=js实现JSONP跨域

select - CSS选择器，配合encode=js自动填充页面元素，默认.hitokoto

min_length - 返回句子的最小长度（包含），默认0

max_length - 返回句子的最大长度（包含），默认30

响应结果

等待中

// 结果将在此处显示...

参数名	类型	必填	描述
key	string	否	平台 API 访问密钥（选填）
c	string	否	句子类型：a动画 b漫画 c游戏 d文学 e原创 f网络 g其他 h影视 i诗词 j网易云 k哲学 l抖机灵，支持多选如c=a&c=h
encode	string	否	返回编码：json(默认) text(纯文本) js(JavaScript)
charset	string	否	字符集：utf-8(默认) gbk
callback	string	否	异步回调函数名，配合encode=js实现JSONP跨域
select	string	否	CSS选择器，配合encode=js自动填充页面元素，默认.hitokoto
min_length	integer	否	返回句子的最小长度（包含），默认0
max_length	integer	否	返回句子的最大长度（包含），默认30

随机一言·网络

接口信息

QQ昵称获取