Qyuan-Api

API 接口分类

按分类浏览所需接口，支持快速筛选，一键查看详情与调用示例

工具类

查询官方机器人

用于查询官方机器人的介绍和QQ与appid

查看详情

工具类

查询官方机器人2

用于查询官方机器人的介绍和QQ与appid

查看详情

工具类

文本转图Api

可以用Api把文本转成图片，支持自定义字体、颜色与背景

查看详情

工具类

WebHook

独立高并发线路，支持多平台回调，稳定接收推送数据

查看详情

工具类

聚合内容

把多平台内容聚合起来的Api，一键获取整合信息

查看详情

工具类

查询性别

用于查询个人、家人的性别信息，支持多参数校验

查看详情

工具类

取随机数

用于不知道选多少数，支持自定义范围、步长与数量

查看详情

娱乐类

随机图片

随机生成不同分类图片，支持自定义尺寸与格式输出

查看详情

娱乐类

随机一言

随机输出励志、哲理、文艺等类型的一句话内容

查看详情

娱乐类

真心话大冒险

输了你就来用吧，随机生成真心话问题与大冒险任务

查看详情

娱乐类

复读接口1

纯复读接口，接收参数后原样返回，支持文本/JSON格式

查看详情

网络类

ping

ping指定网站，获取延迟、丢包率等网络连通性数据

查看详情

网络类

检测网站状态

检测指定网站状态，返回状态码、响应时间、是否在线

查看详情

网络类

获取外网ip

获取你访问时的外网IP地址，附带地理位置、运营商信息

查看详情

网络类

whois

获取你域名的dns解析地址

查看详情

开发文档

简介

本平台提供的 API 接口支持 HTTP/HTTPS 协议，采用 RESTful 设计风格，返回格式统一为 JSON。所有接口均支持跨域请求，适用于 Web 端、移动端、小程序等多种开发场景。

接口调用频率限制：普通用户 100 次/分钟，认证用户 1000 次/分钟。如需更高频率，请联系客服申请扩容。

基础地址

https://api.qyuan.asia/api/

所有接口均基于以上基础地址拼接，例如「文本转图 API」的完整请求地址为：https://api.qyuan.asia/api/v1/wbzt

认证方式

部分接口需要认证后才能调用，认证方式为 API Key 认证，需在请求头中携带以下参数：

Authorization: Bearer {你的 API Key}

API Key 获取方式：

注册并登录平台账号
进入「个人中心 - API 管理」页面
点击「生成 API Key」按钮，即可获得专属密钥

⚠️ 注意：API Key 为敏感信息，请妥善保管，切勿泄露给他人。如不慎泄露，请及时在平台上重置。

工具类接口

1. 文本转图 API

接口地址：/wbzt

请求方式：POST

是否需要认证：否

请求参数：

{ "text": "需要转换的文本", // 必选，字符串 "fontSize": 24, // 可选，字体大小，默认 24px "fontColor": "#000000", // 可选，字体颜色，默认 #000000 "bgColor": "#ffffff", // 可选，背景颜色，默认 #ffffff "fontFamily": "SimHei" // 可选，字体，默认 SimHei（黑体） }

返回结果：

{ "code": 200, // 状态码，200 表示成功 "msg": "success", // 提示信息 "data": { "imageUrl": "https://xxx.com/image.png" // 生成的图片 URL } }

2. WebHook API

接口地址：/webhook

请求方式：POST

是否需要认证：是

请求参数：

{ "url": "你的回调地址", // 必选，接收推送数据的 URL "method": "POST", // 可选，回调请求方式，默认 POST "headers": {}, // 可选，回调请求头 "data": {} // 可选，需要推送的数据 }

返回结果：

{ "code": 200, "msg": "success", "data": { "hookId": "wh_123456" // WebHook 唯一标识 } }

更多工具类接口（聚合内容、查询性别、取随机数）的详细文档，请查看对应接口的「查看详情」页面。

娱乐类接口

1. 随机图片 API

接口地址：/sjtp

请求方式：GET

是否需要认证：否

请求参数（URL 拼接）：

?category=美女 // 可选，图片分类（美女、风景、动漫、动物等），默认随机 &width=800 // 可选，图片宽度，默认 800px &height=600 // 可选，图片高度，默认 600px &format=jpg // 可选，图片格式（jpg/png），默认 jpg

返回结果：

{ "code": 200, "msg": "success", "data": { "imageUrl": "https://xxx.com/random.jpg", // 随机图片 URL "category": "美女", // 图片分类 "width": 800, // 图片宽度 "height": 600 // 图片高度 } }

更多娱乐类接口（随机一言、真心话大冒险、复读接口1）的详细文档，请查看对应接口的「查看详情」页面。

网络类接口

1. ping API

接口地址：/ping

请求方式：GET

是否需要认证：否

请求参数（URL 拼接）：

?url=www.baidu.com // 必选，需要 ping 的网站地址（无需 http/https） &count=4 // 可选，ping 次数，默认 4 次

返回结果：

{ "code": 200, "msg": "success", "data": { "url": "www.baidu.com", "averageDelay": 12.5, // 平均延迟（ms） "maxDelay": 15.2, // 最大延迟（ms） "minDelay": 10.1, // 最小延迟（ms） "lossRate": 0 // 丢包率（%） } }

更多网络类接口（检测网站状态、获取外网ip、whois）的详细文档，请查看对应接口的「查看详情」页面。

错误码说明

错误码	说明	解决方案
200	请求成功	无
400	参数错误	检查请求参数是否完整、格式是否正确
401	未授权	检查 API Key 是否正确、是否过期
403	权限不足	该接口需要更高权限，联系客服升级账号
429	请求频率过高	降低请求频率，或联系客服申请扩容
500	服务器内部错误	稍后重试，或联系客服反馈问题

高效、稳定的 API 接口服务

API 接口分类

查询官方机器人

查询官方机器人2

文本转图Api

WebHook

聚合内容

查询性别

取随机数

随机图片

随机一言

真心话大冒险

复读接口1

ping

检测网站状态

获取外网ip

whois

开发文档

文档目录

简介

基础地址

认证方式

工具类接口

1. 文本转图 API

2. WebHook API

娱乐类接口

1. 随机图片 API

网络类接口

1. ping API

错误码说明

平台优势

稳定可靠

灵活配置

优质服务

关于我们