DrawThings 图像生成

使用 DrawThings 生成图像——这是一款面向 Mac 平台的本地 Stable Diffusion 实现，支持 MLX/CoreML 加速。DrawThings 提供了与 Automatic1111 兼容的 API，可用于程序化图像生成。

适用场景

当您需要执行以下操作时，请使用本技能：

• 根据文本提示生成图像
• 对同一概念生成多种变体
• 批量生成多张图像
• 测试不同模型 / 采样器 / 参数设置
• 按指定尺寸或质量参数生成图像

配置

设置环境变量 DRAWTHINGS_URL（默认值为 http://127.0.0.1:7860）：

export DRAWTHINGS_URL="http://127.0.0.1:7860"

或在 OpenClaw 中配置：

openclaw config set env.DRAWTHINGS_URL "http://127.0.0.1:7860"

快速开始

生成单张图像：

python3 scripts/generate.py "a cyberpunk cat in neon city"

使用自定义参数：

python3 scripts/generate.py "a cyberpunk cat" 
  --steps 20 
  --cfg-scale 7.5 
  --width 768 
  --height 768 
  --sampler "DPM++ 2M Karras"

批量生成（5 个变体）：

python3 scripts/generate.py "a fantasy landscape" --batch-size 5

保存至指定路径：

python3 scripts/generate.py "portrait photo" --output ./outputs/portrait.png

API 使用说明

该技能提供一个 Python 脚本，封装了 DrawThings 的 API（兼容 Automatic1111）：

主端点： POST /sdapi/v1/txt2img

常用参数：

• prompt — 图像的文本描述
• negative_prompt — 图像中需避免的内容
• steps — 扩散步数（范围：8–50，默认：20）
• sampler_name — 采样器算法（默认："DPM++ 2M Karras"）
• cfg_scale — 分类器无关引导尺度（范围：1.0–20.0，默认：7.0）
• width / height — 图像尺寸（默认：512×512）
• batch_size — 生成图像数量（默认：1）
• seed — 随机种子，用于结果复现（-1 表示随机）

完整 API 文档请参见 references/api-reference.md。

预设配置

快速模式（8 步，UniPC Trailing）：

python3 scripts/generate.py "your prompt" --preset fast

高质量模式（30 步，DPM++ 2M Karras）：

python3 scripts/generate.py "your prompt" --preset quality

NFT 模式（针对 512×512 优化，细节表现更佳）：

python3 scripts/generate.py "your prompt" --preset nft

工作流示例

角色变体生成：

python3 scripts/generate.py "electric sheep, glowing wool, cyberpunk" 
  --batch-size 10 
  --steps 20 
  --cfg-scale 7.5

高分辨率输出：

python3 scripts/generate.py "detailed portrait" 
  --width 1024 
  --height 1024 
  --steps 30 
  --sampler "DPM++ 2M Karras"

可复现的图像生成：

python3 scripts/generate.py "landscape" --seed 42
# 使用相同 seed 可获得完全一致的输出

输出

生成的图像以 PNG 格式保存，并嵌入元数据：

• 正向提示词（prompt）、负向提示词（negative_prompt）
• 生成参数（steps、sampler、cfg_scale 等）
• 时间戳与随机种子（seed）

默认保存路径：./drawthings_output_YYYYMMDD_HHMMSS.png

故障排查

"Connection refused"（连接被拒绝）

• 确保 DrawThings 应用正在运行
• 检查 DrawThings 偏好设置中是否已启用 API 服务
• 确认端口号一致（默认：7860）

"Generation failed"（生成失败）

• 检查提示词长度（CLIP 模型每段最多约 75 个 token）
• 若显存不足，请降低图像尺寸
• 尝试更换其他采样器

生成速度缓慢

• 减少扩散步数（草稿可使用 8–12 步）
• 降低图像尺寸（例如 512×512）
• 选用更快的采样器（如 UniPC、Euler A）

画布显示异常（仅视觉层面）

• DrawThings UI 不会在每次生成前清空画布
• 新图像在应用界面中会叠加显示于前一张图像之上
• 此现象仅为界面渲染问题，不影响 API 输出结果

使用技巧

• CFG Scale（引导尺度）：较低值（1–3）适合创意/艺术风格；较高值（7–12）更严格遵循提示词
• Steps（扩散步数）：草稿建议 8–12 步，最终图像建议 20–30 步，50 步以上极少需要
• Samplers（采样器）：UniPC / Euler A 速度快；DPM++ 2M Karras 画质优；LCM 适用于超高速生成
• Dimensions（图像尺寸）：建议保持为 64 的整数倍（如 512、768、1024）
• 批量处理：请使用 --batch-size 参数生成多个变体，而非重复调用脚本

模型

DrawThings 支持 Stable Diffusion 模型。如需切换模型，请执行以下步骤：

1. 打开 DrawThings 应用
2. 在 UI 中选择目标模型
3. API 将自动使用当前选中的模型

推荐模型列表及下载来源详见 references/models.md。