test
📖 技能介绍
name: text-to-image description: 使用本地 ComfyUI 生成图片的技能。当用户提到文生图、生成图片、画一张、AI 绘图、文字转图片、text to image、prompt 生成图片、用文字生出图片，或任何通过文字描述生成图片的需求时，都应使用本 Skill。即使用户没有明确说"ComfyUI"，只要意图是通过本地模型将文字描述变成图片，就应触发。支持选择模型、设置分辨率、调整采样参数、返回生成图片 URL。
Text to Image — 本地 ComfyUI 文生图
通过本地部署的 ComfyUI（默认 http://127.0.0.1:8188）实现文本到图片的生成。Skill 封装了提交任务、轮询进度、提取结果 URL 的完整流程，让你只需关注 Prompt 描述和参数调优。
核心流程
- 理解需求 — 从用户的自然语言描述中提取图片主题、风格、构图等信息
- 组装参数 — 将需求转化为 ComfyUI 可执行的 Prompt 和参数
- 调用脚本 — 执行
scripts/comfyui_api.py提交生成任务 - 返回结果 — 将生成的图片 URL 返回给用户
参数说明
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
prompt |
是 | — | 正向提示词，描述你想生成的图片内容 |
negative_prompt |
否 | "" |
反向提示词，描述你想避免的内容 |
width |
否 | 1024 |
图片宽度（像素） |
height |
否 | 1024 |
图片高度（像素） |
steps |
否 | 20 |
采样步数，越大越精细但越慢 |
cfg_scale |
否 | 7.0 |
CFG 引导系数，控制 Prompt 对生成结果的引导强度 |
seed |
否 | -1 |
随机种子，-1 表示随机 |
sampler_name |
否 | euler |
采样器名称 |
scheduler |
否 | normal |
调度器类型 |
checkpoint |
否 | — | 模型检查点名称，留空则使用 ComfyUI 当前加载的模型 |
comfyui_url |
否 | http://127.0.0.1:8188 |
ComfyUI 服务地址 |
Prompt 编写指南
好的 Prompt 是文生图质量的关键。写 Prompt 时注意以下几点：
- 主体明确：首先要描述画面的核心主体，比如"一只白色小猫"、"未来城市的天际线"
- 风格指引：指定艺术风格会影响整体观感，如"油画风格"、"赛博朋克"、"宫崎骏动漫风"、"写实摄影"
- 细节描述：添加环境、光照、构图等细节，如"金色夕阳逆光"、"背景是模糊的花园"、"俯视构图"
7w4.net小葱技能站，你的AI助手技能库。
- 质量标签：在 Prompt 末尾加上质量增强词，如
masterpiece, best quality, highly detailed, 8k - 反向提示词：用
negative_prompt排除不想要的元素，常见的选择如lowres, bad anatomy, bad hands, cropped, worst quality
Prompt 示例
示例 1：写实风格
- Prompt: a white kitten sitting on a wooden desk, soft natural lighting, shallow depth of field, photorealistic, 8k, highly detailed
- Negative: lowres, blurry, deformed, bad anatomy
示例 2：动漫风格
- Prompt: a girl standing in a field of lavender, sunset glow, Studio Ghibli style, anime art, vibrant colors
- Negative: lowres, bad anatomy, bad hands, text, watermark
示例 3：概念设计
- Prompt: futuristic floating city above clouds, neon lights, cyberpunk aesthetic, concept art, matte painting, ultra detailed
- Negative: lowres, grayscale, blurry, simple background
脚本用法
# 基础文生图
python3 scripts/comfyui_api.py --prompt "一只白色小猫坐在木桌上" --width 1024 --height 1024
# 指定反向提示词和采样参数
python3 scripts/comfyui_api.py \
--prompt "a white kitten sitting on a wooden desk, photorealistic, 8k" \
--negative-prompt "lowres, blurry, deformed" \
--steps 25 \
--cfg-scale 7.5 \
--sampler-name euler_ancestral
# 指定模型检查点
python3 scripts/comfyui_api.py \
--prompt "赛博朋克城市夜景" \
--checkpoint "v1-5-pruned-emaonly.safetensors"
# 指定 ComfyUI 地址
python3 scripts/comfyui_api.py \
--prompt "山水画风格的中国古典园林" \
--comfyui-url "http://192.168.1.100:8188"
脚本执行成功后会输出 JSON 格式的结果，包含 image_urls 字段，其中是生成图片的 URL 列表。例如：
{
"status": "success",
"image_urls": [
"http://127.0.0.1:8188/view?filename=ComfyUI_00001_.png&subfolder=&type=output"
],
"prompt_id": "abc123",
"seed": 42
}
分辨率建议
不同场景适合不同的分辨率，选择时需兼顾模型能力与生成速度：
| 场景 | 推荐分辨率 | 说明 |
|---|---|---|
| 头像/图标 | 512x512 或 768x768 | 小尺寸生成快 |
| 手机动图 | 768x1344 或 832x1216 | 竖屏比例 |
| 桌面壁纸 | 1344x768 或 1216x832 | 横屏比例 |
| 社交媒体 | 1024x1024 | 方图，通用场景 |
| 高清大图 | 1536x1024 或 1024x1536 | SDXL 模型推荐 |
故障排查
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 连接被拒绝 | ComfyUI 未启动 | 启动 ComfyUI：python main.py --listen 0.0.0.0 |
| 模型不存在 | checkpoint 名称错误 | 检查 models/checkpoints/ 目录或省略 --checkpoint 使用当前模型 |
| 生成超时 | 步数过多或图片过大 | 降低 --steps 或减小图片尺寸 |
| 图片质量差 | Prompt 不够具体 | 参考 Prompt 编写指南，添加风格和质量标签 |
| 显存不足 | 分辨率太高 | 降低 width/height 或使用 --steps 15 减少计算量 |
更多信息
- 关于 ComfyUI API 的详细参数和工作流模板，见
references/ability-catalog.md
🤖 AI 评测
这个 Skill 质量较好，文档非常详细，对新手友好，提供了完整的参数说明和使用示例。它能稳定完成基础的文生图任务，脚本功能实用。主要不足是功能较为基础，仅支持简单的文生图，无法使用 ControlNet、LoRA 等进阶功能。另外缺少测试用例，可能存在潜在的稳定性风险。总体而言，适合对 ComfyUI 有一定了解的用户使用，功能扩展性有待提升。
