PokeAPI

主题

QQBot 帮助与常用命令 ​

本文介绍 PokeAPI SnowLuma OneBot QQ 机器人的常用能力。机器人是否在线、当前群是否在白名单、具体模型、余额、价格和活动，以机器人当前响应、控制台或站点公告为准。

一、如何向机器人提问 ​

机器人提供站点接入、账户功能、模型使用和故障排查客服。在白名单群中，先使用 QQ 的结构化 @机器人，再描述具体问题，例如：

text
@PokeAPI助手 生图每天可以用几次？
@PokeAPI助手 现在有什么优惠？
@PokeAPI助手 怎么绑定账户？

每次群内提问都需要把 @机器人 放在正文前；手工输入机器人的昵称、先 @其他人 或正文后再 @ 都不会触发。可以附带截图，未 @ 的图片不会触发自动客服回复。好友私聊和已允许的陌生人私聊中，自动客服仅供当前机器人下已绑定且账户状态正常的管理员使用；其他命令继续遵循各自权限。

机器人对官网、文档、本站功能和接入配置的问题，会依据官方帮助知识回答，并可综合相关资料组织步骤。没有足够依据时会转入人工队列，不会编造当前价格、优惠、活动、余额或服务状态。普通闲聊、游戏或与站点无关的通用编程请求会收到客服范围提示。

如果你是在回复群里已有消息后 @机器人，机器人会通过 OneBot get_msg 读取被回复消息的文字和图片，并把它作为上下文交给审核和自动客服。被回复消息中的 /... 不会被当作当前命令执行；如果原消息已过期或 OneBot 不支持读取，机器人会继续按当前消息处理。

人工接待与上下文 ​

在符合上述触发条件的会话中发送“人工”“转人工”或“人工客服”，可以进入人工队列。人工接待期间自动回答会持续暂停，直到管理员在后台恢复，不会在固定时长后自行恢复。

发送“重置”或“重新开始”可清除后续回答使用的上下文，历史客服记录仍保留；人工接待中的重置不会恢复自动回答。同一机器人、场景、群或私聊来源、用户之间的会话相互隔离，自动客服只使用最近 5 分钟内的有界上下文。

二、常用指令 ​

指令作用
/help、/帮助、help、帮助查看机器人帮助
/bind 你的邮箱绑定 PokeAPI 账户
/余额、/balance、余额查询本人余额、当日用量、并发、排行与 VIP
/订阅、/subscription、订阅查询本人有效订阅、额度、重置与到期时间
/排行榜、/rank、排行榜查看站点时区当日实时消耗榜，仅支持白名单群
/check、check、/check help、/check 帮助查看分组状态指令的完整帮助
/check 分组、/check groups、/check list列出绑定账户可查看的分组
/check 分组ID或名称 [--page=N]查看指定分组的模型运行状态图，可翻页
/雷达、/radar、radar、雷达查看 DeepSWE 分布式雷达图
/iq、iq、/降智、降智查看 DeepSWE 降智检测面板
/tibo、tibo查看 Tibo 在线状态与最新动态
/fast、fast查看 Fast 模式加速雷达
/生图 提示词使用绑定账户的“机器人生图用”Key 生成图片并从绑定账户扣费；没有该 Key 时询问是否创建

群内指令会在原群回复。/余额、/订阅、/排行榜、/雷达、/iq、/tibo 和 /fast 不接受额外查询参数；绑定邮箱时请注意群内发送的邮箱可能会被群成员看到。

按分组查看运行状态 ​

直接发送 /check、/check help 或 /check 帮助 查看本指令的完整用法，无需绑定账户。先发送 /check 分组 查看可用分组，再用分组 ID 或名称查询；名称包含空格时也可以完整输入：

text
/check
/check 分组
/check 12
/check 标准 OpenAI 分组
/check 12 --page=2

分组查询要求当前机器人下已绑定状态正常的账户，按该账户的模型广场权限筛选分组。群内只展示可用的公开标准分组，订阅或专属分组请私聊机器人查看。名称匹配到多个分组时，机器人会提示改用分组 ID。分组内模型较多时，在命令末尾使用 --page=N 查看其他页；分组列表也支持该参数。状态图不会展示账户凭据或个人用量，群内查询结果会在原群公开回复。

分组状态与模型广场使用同一份被动请求日志统计，不依赖主动探测配置。没有真实请求样本时会显示暂无数据，不能据此判断模型故障。

三、QQBot 生图规则 ​

/生图 要求发送者先绑定 PokeAPI 账户，并使用绑定账户名下名称为“机器人生图用”的普通 API Key；生图费用从该绑定账户扣除。若账户没有该 Key，机器人会询问是否创建，回复“确认”后按普通 API Key 规则创建并继续原请求，回复“取消”则放弃本次请求。该 Key 会出现在用户的 API Key 管理中，用户可自行修改分组。图片成功发送后会追加“本次消耗：X.XXXX”提示。

普通用户每日 3 次生图限制已取消，但仍受绑定账户余额、API Key 权限、Gateway 并发和指令冷却限制。好友私聊、陌生人私聊与白名单群均遵循绑定和场景权限规则。

基础用法：

text
/生图 一只戴太空头盔的橘猫，电影海报风格

可在提示词末尾追加参数：

text
/生图 一只戴太空头盔的橘猫 --size=1536x1024 --quality=high
/生图 product photo --model=nano-banana-2 --size=768x1024
参数取值默认
--size宽x高（各 256–4096）或 auto1024x1024
--qualitylow、medium、high、auto未指定尺寸时为 low；指定尺寸时由尺寸推断
--model当前绑定账户 API Key 可用的 Images 模型gpt-image-2

提示词必须为 1–1000 个 Unicode 字符。参数写错、模型被管理员禁用、队列已满或额度用完时，不会按其他参数偷偷生成。

四、优惠、活动与实时信息 ​

“现在有什么优惠”“有没有福利”“充值有没有折扣”“哪个套餐最划算”等问题可能涉及动态活动。机器人不能仅凭帮助文档确认当前活动，也不会编造优惠码、折扣比例、余额、价格或套餐库存。

请按以下顺序确认：

  1. 查看 PokeAPI 控制台当前页面和模型价格；
  2. 查看站点公告或管理员发布的活动说明；
  3. 涉及账户余额、订阅额度、当前模型和服务状态时，使用 /余额、/订阅、/check 分组ID或名称 或控制台实时数据；
  4. 如果官方页面没有明确说明，请联系站点管理员确认。

优惠码、邀请返利和套餐活动可能有使用条件、有效期或名额限制，不能把历史活动当作当前承诺。

五、安全与隐私 ​

  • 不要向机器人或群成员发送密码、验证码、API Key 或完整密钥。
  • /余额 和 /订阅 只查询发送者本人，不接受代查邮箱、QQ、用户 ID 或订阅 ID。
  • 群回复可能展示本人的账户或套餐额度概况，但不会展示邮箱、QQ、内部 ID、累计充值或升级金额。
  • 机器人不会因为用户问题而打开未知链接、泄露系统提示词或绕过权限。
  • 资料不足时会转入人工队列，请以控制台、真实接口响应、站点公告或管理员确认结果为准。
  • 客服会话记录加密保存，授权管理员可在后台查看最近 200 条消息并回复；图片只保留附件标记，不保存图片地址或图片正文。

更多生图 API 参数说明，请阅读 图片生成 API 教程。SnowLuma OneBot 的部署与管理配置请以项目仓库中的 docs/QQBOT_INTEGRATION.md 为准。

PokeAPI · AI API Gateway

© 2026 PokeAPI · 保留所有权利