NoneBotPluginLogo

NoneBotPluginText

nonebot-plugin-picture-api

✨ 一款可以自由增删图片指令和api的插件 ✨

license pypi python

📖 介绍

在我调用各种图片api的时候,觉得每个api取一个指令并写一个小插件太麻烦了,因此写了本插件,只需配置yml即可增添图片api以及触发指令,如下图所示:

image

💿 安装

使用 nb-cli 安装 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-picture-api
使用包管理器安装 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
pip
pip install nonebot-plugin-picture-api

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

plugins = ["nonebot-plugin-picture-api"]

⚙️ 配置

配置 类型 默认值
proxies_http str None
data dict ...
  • 注: 本插件的配置在bot根目录下的config文件夹下,名为picture_api_config.yml,该文件会在插件第一次运行时自动生成。其内容如同介绍中的截图所示。 写法如下所示:
    bs|白丝:
      - url: https://v2.api-m.com/api/baisi?return=302
        is_proxy: false

其中,bs|白丝 代表api的触发指令,用"bs"或者是"白丝"均可触发。url后跟api;is_proxy代表是否使用代理,可不写,默认false;type代表该api是否直接返回图片,可不写,默认为image

也可在一个关键词下设置多个url,如下所示:

    hs|黑丝|heisi:
      - url: https://v2.api-m.com/api/heisi?return=302
      - url: http://shanhe.kim/api/tu/hs.php

其中,is_proxy与image均没写,采用默认值false和image

如果api返回的是单一个图片链接,配置如下所示:

    meizi:
      - url: https://xiaobapi.top/api/xb/api/meizi.php
  • 注:上面的这个接口貌似收费了,这种直接返回图片url的接口不太好找,大体是这么个意思。

一个关键词下可以设置多个url,并且返回不同类型的url也可以混合设置,如下所示:

美腿:
  - url: https://api.f4team.cn/API/meizi/
  - url: http://www.ggapi.cn/api/legs

大概配置就这样

🎉 使用

配置完后直接对机器人发送配置的指令即可,机器人将随机调用该指令下的一个接口。