帮助文档

欢迎体验我们的机器人API服务

  • 功能简介
  • 机器人API
  • 调用示例
  • 常见问答
功能简介
聊天插件

AI聊天,与知识库灵活搭配,让你的机器人更具多元化。

用户中心插件

支持自定义经验别名、金币别名、等级经验规则,等级级别名指定等等。

个人中心/财富榜/等级榜

用户中心插件只在群环境下生效

Ultra插件

支持自定义请求,也就是相当于可以定制其它第三方接口,该插件属于公测阶段,最终形式可能会发生变化。

可以在接入管理里面创建超级订阅,然后在机器人的插件管理里面添加订阅,开启全新的体验。

签到插件

我只能说签到功能很强,其它的自行体验,支持经验、金币配置,支持设置多种连签、排名奖励,支持文本模板和JSON(自定义)回复,未来还会支持图片模式。

签到/签到榜

签到插件只在群环境下生效

天气预报

全国天气预报查询,并且会提示未来的天气变化。

天气/武汉天气

武汉天气【周五~08月13日】:小雨,24℃,东北风(0-3级 微风 <5.4m/s);温馨提示,4小时左右天气有变化:小雨转中雨。

天气预报支持多轮上下文场景对话

手机号归属地查询

可查询全国手机号归属地信息。

手机号/归属地/sjh/mobile/phone查询

手机号前缀:1867230,归属地:湖北武汉,运营商:联通

手机号归属地查询支持多轮上下文场景对话

精选文案/一言

精选一句话。

一言/诗词一言/动画一言/漫画一言/游戏一言/文学一言/原创一言/网络一言/影视一言/网易云一言/哲学一言/抖机灵一言/其它一言

两情若是久长时,又岂在朝朝暮暮。 《鹊桥仙》 - 秦观

翻译功能

通用翻译功能,几乎支持所有语种。

进入翻译模式/翻译hello/Translate i miss you


译文:
----------------
我想你
----------------
回复q退出翻译模式,回复s:lang切换翻译目标语种。

翻译插件支持多轮上下文场景对话

lang 语种 lang 语种
zh 简体中文 en 英语
yue 粤语 wyw 文言文
jp 日语 kor 韩语
fra 法语 spa 西班牙语
th 泰语 ara 阿拉伯语
ru 俄语 pt 葡萄牙语
de 德语 it 意大利语
el 希腊语 nl 荷兰语
pl 波兰语 dan 丹麦语
fin 芬兰语 cht 繁体中文
vie 越南语 san 梵语
swe 瑞典语 hu 匈牙利语
lat 拉丁语 cs 捷克语
成语大全,支持成语接龙,查成语

支持群成员一起成语接龙,也支持私聊接龙,还支持查询成语信息(出处、释义、举例)。

成语接龙


成语接龙(编号23824):
----------------------
当前的成语:随侯之珠
当前已接龙:0次
----------------------
回复【q】退出成语接龙

查成语丢三落四


成语”丢三落四“信息:
----------------------
出处:清·曹雪芹《红楼梦》第六十七回咱们家没人,俗语说的‘夯雀儿先飞’,省的临时丢三落四的不齐全,令人笑话。”
释义:形容做事马虎粗心,不是丢了这个,就是忘了那个。
举例:无
----------------------

成语大全插件支持多轮上下文场景对话

笑话大全插件

有各种笑话,职场、校园、幽默、哲理、冷笑话等等。

笑话/冷笑话/儿童笑话/哲理笑话/女人笑话/幽默笑话/恐怖笑话/文艺笑话/校园笑话/爆笑签名/爱情笑话/短信笑话/职场笑话/节日笑话


让人恍然的几句幽默箴言
----------------------
本质好的人很难做坏事,他们连自己那关都过不了。本质坏的人也很难改变,他们最多只是抑制自己一阵子罢了。所以要相信别人在做的努力,但不要尽信他们会改掉本质。
----------------------
《哲理笑话》

笑话插件支持多轮上下文场景对话

倒计时插件

支持自定义一年365天,每时每刻的倒计时,并且支持公历/农历区分设置。

元旦倒计时/国庆倒计时/高考倒计时

距离高考还有87天12小时26分钟

猜拳插件

支持自定义胜率,自定义猜拳别名等。

猜拳石头/猜拳布/猜拳布20

你出的布,机器人出的石头,你赢啦,加20金币

猜拳插件只在群环境下生效

人生重开模拟器插件

这垃圾人生,一秒也不想呆了,欢迎重开!

人生重开


xxx,欢迎来到人生重开模拟器!
-----------------------------
1、普通10连抽(小盒子)
2、豪华20连抽(随机)
-----------------------------
请回复编号选择天赋礼包。

因时间关系,此插件目前暂不支持自定义配置,后续将陆续完善各种配置,支持各种“魔改”,敬请期待!

目前发布的仅为体验版,如果您有什么好的建议,欢迎向我们反馈,交流方式请前往[关于茉莉]页面查看!

云音乐插件

搜音乐、点歌、看评论!

点歌刚好遇见你/搜歌刚好遇见你


💡 xxxxxx
-----------------------------
🎵 1、刚好遇见你[李玉刚/徐天意-我想和你唱 第二季 第9期]
🎵 2、遇见你(翻自 锦零)[小呱-遇见你]
🎵 3、遇见你(粤语版)[欧阳耀莹-遇见你]
🎵 4、刚刚好(网剧《我与你的光年距离》主题曲)[薛之谦-初学者]
🎵 5、谭艳-光明(王展鹏 Remix)[王展鹏-刚好遇见你]
🎵 6、刚刚好(网剧《我与你的光年距离》主题曲)[薛之谦-我与你的光年距离 网络剧原声带]
🎵 7、清明上河图 (2017新编版)[李玉刚-刚好遇见你]
🎵 8、不后悔遇见你[姜云升/朴冉-不后悔遇见你]
🎵 9、遇见你[姜云升/孟垠希-2017]
🎵 10、逐梦令 (2017新编版)[李玉刚-刚好遇见你]
-----------------------------
🏷当前第1页,共搜到300条结果。
-----------------------------
✨ 回复编号查看歌曲详情
✨ 回复“上一页”或“下一页”翻页

其他功能

如果你有好的想法或建议,欢迎向我们反馈,期待中(QQ群:273970059);

其他功能陆续完善中,敬请期待,已规划功能如下:

  • 数学计算
  • 笑话大全 已完成
  • 故事大全
  • 成语接龙 已完成
  • ip查询
  • 身份证基本信息解析
机器人API
接口地址(Post请求)

https://api.mlyai.com/reply

请求头(Headers)
参数名 必填 说明
Api-Key 开放接口的ApiKey,在机器人详情中获取,机器人创建时就跟随着创建,平台唯一。
Api-Secret 开放接口的ApiSecret,在机器人详情中获取,机器人创建时会随机生成秘钥,后续可以自行修改。
Content-Type application/json;charset=UTF-8
请求参数(Json对象)
参数名 必填 说明
content 消息主体,跟机器人交互的文本(长度超过64个字符将被自动截取,只保留前64个字符)
type 对话场景,:私聊,:群聊(对话场景不一样,from和to参数的含义也不一样)
from 消息发送者标识符(ID):群消息时,此值表示群成员;好友消息时,此值表示好友。(长度超过32个字符将被自动截取)
fromName 消息发送者名字或昵称:群消息时,此值表示群成员;好友消息时,此值表示好友。(长度超过32个字符将被自动截取)
to 是/否 消息接收者标识符(ID):群消息时此值表示群标识;好友消息时此值不用传,并且无效。(长度超过32个字符将被自动截取)
toName 消息接收者名字或昵称:群消息时此值表示群名;好友消息时此值不用传,并且无效。(长度超过32个字符将被自动截取)
接口响应结果(Json)
字段名 字段类型 说明
code 字符串 响应码,此值非都为异常状态码
message 字符串 接口响应的消息提示,异常状态码可以参考此值的消息提示
plugin 字符串 此次调用的最终处理插件,有Chat、Weather、Translation等,详细见下面,如果为则表示是万金油回复
data 数组 当接口响应码为时,就会响应接口的正确数据
接口响应示例(Json)

{"code":"00000","message":"请求成功","plugin":null,"data":[{"content":"不懂,style正在学习中,说不定下次就会回答了","typed":1,"remark":null}]}

接口返回的是json,code表示状态码,message表示本次调用情况的描述,plugin表示提问被处理的插件,如果为则表示万金油回复,data是本次调用返回的具体数据,注意,这个data是一个json数组,表示一个提问允许有多个连续的回答;

data数组里面的typed表示当前回复的类型,1:文本,2:图片,3:文档,4:音频,8:JSON字符串,9:其它文件;

当data数组里面的typed为文本时,content表示回答文本内容;当data数组里面的typed为非文本,比如typed=2(图片)时,content表示此回答的图片文件相对地址,remark表示附件上传时的原文件名;

词库回答里面的附件(图片、文档、音频和其它文件都是附件)访问地址是: +

比如data里面的typed=,content=,则这个文件的真实访问地址是

注意,因为Ultra插件是第三方接口返回的内容,所以Ultra插件返回的文件均为绝对地址,不需要拼接茉莉云的文件地址。

接口响应状态码

当接口返回的code值是的时候,表示请求成功,其他的值都表示失败的请求,不会计入调用次数,当值为时表示当日调用次数已用完。

插件列举

:Ai聊天插件

:天气预报插件

:成语大全、接龙插件

:手机号归属地查询插件

:商城联盟插件

:笑话插件

:精美古诗词插件插件

:翻译插件

调用示例
Java (springboot)
Kotlin
PHP
NodeJS
Python
其他语言

其他语言请参考机器人API自行实现,如果有需要,请联系我们补充。

常见问答
这个网站是干什么的?

这个网站主要是提供机器人Api服务的,此网站不提供具体的机器人软件,您使用的软件可能是其他开发者制作。

有没有推荐的机器人软件?

如需使用比如qq聊天机器人,微信聊天机器人等,请前往论坛探索,或者看本站顶部导航「谁在使用」。

知识库的权重设置有什么用?

用户的每个知识库都可以自己设置它的权重,一共有5个档,分别为极低、较低、正常、较高、极高,从左到右,权重依次升高,系统默认的知识库都是档。

知识库权重越高,此知识库对应的词库优先级也就越高。比如知识库A和知识库B,都设有一个提问:「你好啊」,假如知识库A比知识库B的权重高,那么机器人在引用了这两个知识库的情况下,会优先使用知识库A对应的回答。

注意:知识库权重高,就不一定此知识库的词库在任何情况下都会优先,还是得看具体都语义,只有语义相近的情况下,才会优先。

提示:知识库权重高不是设置的越高就会越好,请合理设置;

例如,设置系统默认知识库权重是档,自己添加一个知识库A是档,假如用户提问:,默认库有一个词库是,知识库A有一个词库是,这个明显默认知识库的回复更合适,但是因为权重设置问题,可能会导致知识库A的词库加分高,机器人回复的是知识库A的回答;

所以闲聊库与默认库基本一致就行,不需要过多设置,当你的知识库是某垂直领域的问答,这时您才考虑适当调高知识库的权重。

知识库的匹配阈值设置有什么用?

AI智能聊天插件在回答问题的时候,会计算词库和提问语义的匹配度,匹配度从0到100%,匹配度越高,语义相似度也就越高;

之前知识库没有这个设置,系统有一个默认的匹配度阈值,低于这个值,则不会被触发,当所有词库都没有达标,则机器人使用万金油回复;

现在这个设置加上之后,用户可以自己控制这个匹配阈值(也就是匹配度阈值),匹配阈值设置最低值为10%,最高为100%,100%表示知识库的词库和提问完全匹配才会触发,请谨慎设置,这将影响机器人的回复结果。

提示:知识库匹配阈值不是设置的越高就会越好,请合理设置;

例如,设置知识库A的匹配阈值为100%,假如用户提问:,知识库A有一个词库是,这个匹配度大概有80%左右,但是小于知识库A的匹配阈值设定,则不会被触发;

所以知识库一般情况匹配阈值默认就行了,不需要过多设置,当你的知识库需要高精度匹配,甚至要求词库与提问语句完全相同时,这时您才考虑适当调高知识库的匹配阈值。

词库回答里面的代码有哪些,以及作用?

目前有,分别表示机器人名字,对方的称呼,对方的昵称(api接口收到的消息发送者昵称),爸爸,妈妈,年龄,性别,星座。

词库里面加这些代码,会在机器人回复时自动替换成相应的信息。比如词库回答里面有一个:如果名为"茉莉"的机器人使用此词库,那么回复时,会被替换为"茉莉";如果名为"二狗子"的机器人使用此词库,那么回复时,会被替换为"二狗子"。

一个词库的提问和回答为什么都可以填多个?

提问有多个,表示相似提问,只要任意一个符合用户的消息语义,都可以触发对应的回复。回答有多个,表示一个提问,机器人可以回答多条消息,所以Api接口数据返回的是一个数组。

词库编辑里面的回复类型和适用性别什么意思?

回复类型是针对当前词库回答列表的处理方式,表示回答列表里面的所有回答都会回复,一次性回复多条消息,表示每次都从回答列表里面随机抽取一条进行回复。

适用性别表示当前词库与机器人性别是否适用,比如词库适用性别设置的为”女“,则此词库只会对女性机器人生效,设置为”全部“表示男女通用。

支持通过上传文件批量导入词库吗?

支持,在知识库详情里面,有导入功能。导入时请注意知识库容量哦。

一个知识库可以被多个机器人应用吗?

可以的,不管是系统的知识库,还是自己创建的知识库,都可以被不同的机器人重复应用。

机器人信息里面的"万金油回复"是什么意思?

字面意思是通用的回复,主要用在机器人不知道怎么回复时,就会从万金油回复列表中随机选择一个回复(原:随机回复),如果机器人没有设置,系统也会有默认的万金油回复。

为啥我添加了词库,机器人没有效果?

请检查机器人是否应用了该知识库。

为啥我的机器人没有xxx功能?

请检查机器人是否应用了该插件

Api调用量不够使用怎么办?

茉莉云秉承着开放、免费的态度,一般情况下基本足够支撑普通用户使用,对于重度使用Api的用户,我们提供了会员服务,升级会员能享受更多的调用量,也是对我们服务压力的均摊,感谢!

如果您的项目用于教育、公益,请联系我们免费为您升级会员服务。

Api返回请求方式不正确或参数不正确?

接口是Post请求,并且参数是Json对象,请参考机器人Api仔细核对相关信息,或查看调用示例。

如果你用postman测试,在传参类型那一栏选择body -> raw -> JSON。

微信公众号怎么接入?

暂时只支持通过开发者信息接入,先在控制台添加微信公众号,然后把生成的「开发配置」填入微信公众平台并启用,这样微信公众号就会自动回复消息了。

如果想自定义新用户关注公众号时自动发送消息,请在词库里面添加一个提问「关注微信公众号」,会自动回复对应的回答。