AIDrawing.js 新手指南

你好！这是一个为海豹（SealDice）聊天机器人设计的 AI 绘图插件。它能让你通过简单的文字指令，调用 AI 进行绘图。更重要的是，它可以作为 伟大的错误佬的AIPlugin4 的绘图依赖，为你的 AI 骰娘提供绘图功能。

✨ 主要功能

  • 🌐 兼容性强：支持对接多种不同的 AI 绘图服务商，你可以自由选择和配置。
  • 🔧 配置灵活：可以自定义发送给 AI 的指令细节（请求体），精确控制绘图效果。
  • ⏳ 支持异步任务：如果 AI 绘图需要排队，插件会自动轮询查询结果，完成后再将图片发给你。
  • 👍 使用简单：一个核心命令即可搞定所有操作。

⚙️ 安装与配置

这是最关键的一步，你需要告诉插件如何连接到你选择的 AI 绘图平台。

第一步：安装插件 🛠️

  1. 确保你的海豹核心版本不低于 1.4.5。
  2. 在海豹 WebUI 的 "JS插件" 界面，上传 AIDrawing.js 文件即可完成安装。

第二步：进行配置 ⚙️

在海豹机器人的 扩展功能 -> 插件设置 中找到 AIDrawing，你会看到以下配置项。请根据你选择的 AI 绘图服务商提供的文档来填写。

  • API端点 (API Endpoint)

    • 这是什么？ AI 绘图网站的服务器地址。
    • 怎么填？ 从 AI 平台的 API 文档中找到图片生成的 URL 地址并填入。
    • 示例: https://api.example.com/v1/images/generations

  • 二次请求API端点 (Secondary API Endpoint)

    • 这是什么？ 用于查询异步任务进度的地址。如果你的服务商是立即返回图片，则此项留空。
    • 怎么填？ 从文档中找到查询任务状态的 URL。注意，地址里的 {task_id} 是固定占位符，请勿修改。
    • 示例: https://api.example.com/v1/tasks/{task_id}

  • 自定义_请求体 (Custom Request Body)

    • 这是什么？ 发送给 AI 的具体“订单”详情，如模型、尺寸、描述等。
    • 怎么填？ 这是最复杂的一项。你需要按照 AI 平台文档的要求，将参数一行一行写入。{prompt} 和 {negative_prompt} 是插件会自动替换的占位符，请务必保留。

    • 示例:

      "model":"wanx2.1-t2i-turbo",
"input":"{\"prompt\":\"{prompt}\",\"negative_prompt\":\"{negative_prompt}\"}",
"parameters":"{\"size\":\"1024*1024\",\"n\":1}"

  • 自定义_请求头 (Custom Request Headers)

    • 这是什么？ 访问服务的“身份凭证”，通常包含你的 API 密钥。
    • 怎么填？ 最常见的是 Authorization。将你的 API Key 填入。注意，你需要把示例中的 你的API_KEY 换成你自己的真实 Key。

    • 示例:

      "Authorization":"Bearer 你的API_KEY",
"Content-Type":"application/json"

🎨 使用方法

配置完成后，就可以开始画画了！

命令格式

.generateimage <你想要画的内容> [不想要的内容]
  • <你想要画的内容>：必须填写，这是画面的主要描述（正面提示词）。
  • [不想要的内容]：可选填写，用于排除画面中不希望出现的元素（负面提示词）。

使用示例

  • 示例1：画一只在太空的猫

    .generateimage 一只戴着宇航员头盔的可爱小猫，太空背景

  • 示例2：画一只白色的猫，但不要红色

    .generateimage 一只漂亮的白色波斯猫 红色

🔬 工作原理

当你发送命令后，插件内部会执行以下流程：

  1. 发送命令：你在聊天框输入 .generateimage 指令。
  2. 插件处理：插件将你的描述打包成一个符合服务商要求的请求。
  3. 发送请求：插件将请求发送到你配置的 API端点。

  4. AI 响应：

    • 情况A (同步)：AI 直接处理完成并立即返回图片。
    • 情况B (异步)：AI 返回一个任务ID，表示已接收请求并开始排队处理。插件会使用二次请求API端点定时查询该任务ID，直到获取到最终图片。
  5. 收到图片：插件将最终获得的图片发送回聊天窗口。

📦 服务商方案推荐

这里是一些常见服务商的配置方案，你可以复制后修改 API_KEY 直接使用。

硅基流动 (Siliconflow)

  • 特点：综合性大模型服务商，同步返回，无需二次请求。
  • API端点：https://api.siliconflow.cn/v1/images/generations
  • 二次请求API端点：(留空)

  • 自定义_请求体：

    "model_name":"Kwai-Kolors/Kolors"
"prompt":"{prompt}"
"negative_prompt":"{negative_prompt}"
"image_size": "1024x1024"
"batch_size": 1
"num_inference_steps": 20
"guidance_scale": 7.5

  • 自定义_请求头：

    "Authorization":"Bearer 你的API_KEY"

智谱AI (CogView)

  • 特点：国内服务商，同步返回，无需二次请求。
  • API端点：https://open.bigmodel.cn/api/paas/v4/images/generations
  • 二次请求API端点：(留空)

  • 自定义_请求体：

    "model":"cogview-3",
"prompt":"{prompt}"

  • 自定义_请求头：

    "Authorization":"Bearer 你的智谱AI_API_KEY"

阿里通义万象 (DashScope)

  • 特点：功能强大，支持异步任务，需要在请求头中开启。
  • API端点：https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis
  • 二次请求API端点：https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

  • 自定义_请求体：

    "model":"wanx2.1-t2i-plus",
"input":"{\"prompt\":\"{prompt}\"}",
"parameters":"{\"negative_prompt\":\"{negative_prompt}\", \"size\":\"1024*1024\"}"

  • 自定义_请求头：

    "Authorization":"Bearer 你的阿里DashScope_API_KEY",
"X-DashScope-Async":"enable"

百度千帆、讯飞星火尚未支持