{"skill":{"slug":"liblibai","displayName":"LiblibAI","summary":"使用 LiblibAI API 从文本或图片生成高清 AI 图像，支持多模型、多参数调整及文件上传，适合创意设计和视觉内容创作。","description":"---\nname: liblibai\ndescription: 使用 LiblibAI API 生成 AI 图像。支持文生图、图生图、Ultra 模型、ComfyUI 工作流和文件上传，适合创意设计、内容创作和视觉项目。\nlicense: MIT\nallowed-tools:\n  - Read\n  - Write\n  - Exec\n  - WebFetch\n  - AskUserQuestion\nmetadata:\n  clawdbot:\n    emoji: 🎨\n    requires:\n      bins: [node, npm]\n    install:\n      - id: npm\n        kind: npm\n        pkg: liblibai\n        label: 安装 liblibai npm 包\nconfig:\n  - name: LIBLIBAI_ACCESS_KEY\n    description: LiblibAI API AccessKey（在 https://liblibai.com 账户设置中获取）\n    required: true\n    example: \"AFP8cs3Ip4KsQJr7tmUcWA\"\n  - name: LIBLIBAI_SECRET_KEY\n    description: LiblibAI API SecretKey（与 AccessKey 配对）\n    required: true\n  - name: LIBLIBAI_BASE_URL\n    description: API 端点 URL（默认: https://openapi.liblibai.cloud）\n    default: https://openapi.liblibai.cloud\n    optional: true\n\n---\n\n# LiblibAI Skill - AI 图像生成\n\n强大的 AI 图像生成工具，基于 LiblibAI（星流）平台。适用于：\n\n- 🎨 **创意设计**：概念图、角色设计、场景插画\n- 📱 **内容创作**：社媒配图、文章插图、营销素材\n- 🔬 **视觉实验**：风格转换、图像重绘、ControlNet 控制\n- 🛠️ **工作流集成**：与其他 OpenClaw 技能组合（如 web_search 找灵感，humanizer 优化提示词）\n\n---\n\n## 快速开始\n\n### 1. 获取 API 凭据\n\n访问 [LiblibAI](https://liblibai.com)：\n1. 注册/登录账户\n2. 进入「API 管理」或「开发者设置」\n3. 创建 AccessKey 和 SecretKey\n4. 设置环境变量（推荐）：\n\n```bash\nexport LIBLIBAI_ACCESS_KEY=\"your-access-key\"\nexport LIBLIBAI_SECRET_KEY=\"your-secret-key\"\n```\n\n或通过 OpenClaw 配置系统设置。\n\n### 2. 基本生成\n\n```bash\n# 生成一张 1024x1024 的小狗图片\n./skills/liblibai/bin/cli.js text2img -p \"一只可爱的小狗，真实照片风格，高清\" -W 1024 -H 1024 -s 20\n\n# 查看结果（成功后输出图片 URL）\n# 复制 URL 到浏览器即可查看\n```\n\n---\n\n## 核心功能\n\n### 文生图 (text2img)\n\n从文本生成图像，支持完整参数控制。\n\n**常用参数：**\n```\n-p, --prompt <text>        正向提示词（必需）\n-n, --negative-prompt <text>  负向提示词（如 \"ugly, blurry\"）\n-W, --width <1024>         图像宽度（建议 512-1536）\n-H, --height <1024>        图像高度\n-s, --steps <20>           采样步数（10-50，越高越精细）\n-c, --cfg-scale <7>        提示词引导系数（1-20）\n--sampler <15>             采样方法 ID（15=DPMSolver）\n--seed <-1>                随机种子（-1=随机）\n-i, --img-count <1>        生成数量（1-4）\n-t, --template-uuid <uuid> 参数模板 ID（在 LiblibAI 平台预设）\n```\n\n**示例：**\n```bash\n# 生成插画风格头像\n./bin/cli.js text2img -p \"anime portrait, 1girl, colorful hair, detailed eyes\" -W 768 -H 1024 -s 30 -c 8\n\n# 使用预设模板（需要先在平台创建）\n./bin/cli.js text2img -p \" landscapes\" -t \"your-template-uuid\"\n```\n\n### 图生图 (img2img)\n\n基于现有图像重绘或风格转换。\n\n**特有参数：**\n```\n-S, --source-image <url|path>  源图 URL 或本地路径（支持自动上传）\n-d, --denoising-strength <0.75> 重绘幅度 (0-1, 越高变化越大)\n--resize-mode <0>            缩放模式 (0=拉伸, 1=裁剪, 2=填充)\n--mask-image <url>           蒙版图（用于局部重绘）\n--mask-mode <0>              蒙版模式\n--inpaint-area <0|1>         重绘区域 (0=全图, 1=仅蒙版)\n```\n\n**示例：**\n```bash\n# 将照片转为油画风格（自动上传本地文件）\n./bin/cli.js img2img -p \"oil painting style, Van Gogh\" -S ./photo.jpg -d 0.65\n\n# 局部重绘（需要配合蒙版）\n./bin/cli.js img2img -p \"add a hat\" -S original.png --mask-image mask.png --inpaint-area 1\n```\n\n### Ultra 模型 (text2img-ultra / img2img-ultra)\n\n更高品质的生成，支持 ControlNet。\n\n**特有参数：**\n```\n-a, --aspect-ratio <portrait|landscape|square> 宽高比\n--controlnet-type <depth|canny|...> ControlNet 类型\n--controlnet-image <url>              ControlNet 参考图\n```\n\n**示例：**\n```bash\n# Ultra 文生图 + ControlNet\n./bin/cli.js text2img-ultra -p \"masterpiece, 1girl\" -a portrait --controlnet-type depth --controlnet-image ref.jpg\n```\n\n### 文件上传 (upload)\n\n上传本地图片供后续使用。\n\n```bash\n# 简单上传\n./bin/cli.js upload ./my-image.png\n\n# 自定义文件名\n./bin/cli.js upload ./photo.jpg -n \"reference\"\n```\n\n返回的 URL 可用于 img2img 或 ControlNet。\n\n### 异步任务管理\n\n对于耗时较长的任务（ Ultra 模型、复杂工作流）：\n\n```bash\n# 提交任务（返回 UUID）\nUUID=$(./bin/cli.js submit text2img -p \"complex scene\")\n\n# 检查状态\n./bin/cli.js status $UUID\n\n# 等待完成（自动轮询）\n./bin/cli.js wait $UUID --interval 5000 --timeout 600000\n```\n\n---\n\n## 典型工作流示例\n\n### 工作流 1：概念设计迭代\n\n```bash\n# 1. 生成多个版本的草图（不同种子）\nfor seed in {1..5}; do\n  ./bin/cli.js text2img -p \"character design, fantasy warrior\" --seed $seed -W 512 -H 512 -s 15\ndone\n\n# 2. 选择最佳的一张进行风格重绘\n./bin/cli.js img2img -p \"watercolor painting\" -S best-sketch.png -d 0.7\n\n# 3. Ultra 提升细节\n./bin/cli.js text2img-ultra -p \"high detail, refined\" -a portrait --controlnet-type depth -S refined.png\n```\n\n### 工作流 2：批量生成营销配图\n\n```bash\n# 使用脚本循环生成\nfor product in \"咖啡杯\" \"笔记本\" \"耳机\"; do\n  ./bin/cli.js text2img -p \"$product on white background, product photography\" -W 1024 -H 1024 -s 25 &\ndone\nwait\n```\n\n---\n\n## 故障排除\n\n### 认证失败\n```\nError: LiblibAI credentials not found\n```\n**解决**：确保环境变量已设置。测试：\n```bash\necho $LIBLIBAI_ACCESS_KEY\necho $LIBLIBAI_SECRET_KEY\n```\n如果为空，请在 ~/.zshrc 或当前 shell 中 export。\n\n### 速率限制\n返回 429 错误。\n**解决**：添加延迟（sleep 2-3 秒）或减少生成频率。\n\n### 模板 UUID 问题\n某些高级功能需要平台预设的模板 UUID。\n**解决**：登录 LiblibAI 网页版，在「模板」或「工作流」中创建并获取 ID。\n\n### 文件上传失败\n```\nError: File size exceeds limit\n```\n**解决**：确保文件 < 10MB，格式为 PNG/JPG/JPEG/WebP。\n\n### 网络超时\n中国用户可能需要代理访问 international API。\n**解决**：设置 `LIBLIBAI_BASE_URL` 为国内镜像（如有），或使用稳定网络。\n\n---\n\n## 与其他技能集成\n\n### 结合 web_search 获取灵感\n```bash\n# 搜索当前流行设计风格\nweb_search \"2025 UI design trends\"\n\n# 用搜索结果作为提示词\n./bin/cli.js text2img -p \"modern UI design, dark theme, glassmorphism\" -W 1280 -H 720\n```\n\n### 结合 humanizer 优化提示词\n```bash\n# 用 humanizer 润色提示词，使结果更自然\n# 先在聊天中让 humanizer 优化描述，再传入 text2img\n```\n\n### 在自动化工作流中使用\n```bash\n# 示例：生成配图并写入 MEMORY.md\nURL=$(./bin/cli.js text2img -p \"workflow diagram\" -W 1200 -H 600 | grep -o 'https://[^\"]*png')\necho \"今日生成的流程图: $URL\" >> memory/$(date +%Y-%m-%d).md\n```\n\n---\n\n## 成本与积分\n\n- **消耗**：每次生成消耗 2-5 积分（取决于分辨率、步数、模型）\n- **查询余额**：运行任意命令后，输出中的 `accountBalance` 显示剩余积分\n- **充值**：在 LiblibAI 平台充值增加积分\n\n**建议**：先用小分辨率（512x512）测试提示词，再放大生成以节省积分。\n\n---\n\n## 参数参考表\n\n| 参数 | 类型 | 默认 | 说明 |\n|------|------|------|------|\n| prompt | string | **必需** | 正向提示词，描述你想生成的图像 |\n| negativePrompt | string | - | 负向提示词，排除不想要的元素 |\n| width/height | number | 768/1024 | 图像尺寸（建议 512 的倍数） |\n| steps | number | 20 | 采样步数，质量与速度平衡 |\n| cfgScale | number | 7 | 提示词遵循度 |\n| sampler | number | 15 | 采样器 ID（15=DPMSolver++） |\n| seed | number | -1 | 随机种子（固定种子可复现结果） |\n| imgCount | number | 1 | 生成数量（1-4） |\n| templateUuid | string | - | 预设模板 ID（平台创建） |\n\n---\n\n## 提示词技巧\n\n- **使用逗号分隔**：`\"cat, cute, photorealistic, 8k\"`\n- **权重语法**：`\"(masterpiece:1.2)\"` 提升权重\n- **负面提示词**：始终添加 `\"ugly, blurry, low quality, watermark\"`\n- **风格引用**：`\"by Greg Rutkowski\"`、`\"Studio Ghibli style\"`\n- **质量词**：`\"masterpiece, best quality, highres, 8k\"`\n\n---\n\n## 技术细节\n\n- **SDK**: 使用官方 `liblibai` npm 包（v0.0.11）\n- **API**: 兼容 OpenAI DALL-E 风格接口\n- **超时**: 默认 5 分钟，可通过 `--timeout` 调整\n- **轮询间隔**: 默认 3 秒检查状态\n\n---\n\n## 版本历史\n\n**v1.0.0** (2026-03-13)\n- 初始发布\n- 完整 CLI 支持（text2img, img2img, upload, status, wait）\n- 优化输出格式（清晰图片链接）\n- 环境变量配置\n\n---\n\n## 相关链接\n\n- [LiblibAI 官网](https://liblibai.com)\n- [API 文档](https://liblibai.feishu.cn/wiki/UAMVw67NcifQHukf8fpccgS5n6d)\n- [npm 包](https://www.npmjs.com/package/liblibai)\n- [ClawHub skill 页面](https://clawhub.ai/skill/liblibai)（发布后）\n\n---\n\n## 许可\n\nMIT License - 自由使用、修改和分发。\n\n---\n\n*最后更新: 2026-03-13 · 上海*\n","topics":["内容创作","图像生成","创作","图像","工作流"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":697,"installsAllTime":26,"installsCurrent":1,"stars":1,"versions":1},"createdAt":1773371493791,"updatedAt":1778491872769},"latestVersion":{"version":"1.0.0","createdAt":1773371493791,"changelog":"Initial release of liblibai skill.\n\n- Provides AI image generation services powered by the LiblibAI API.\n- Supports text-to-image, image-to-image, Ultra models, ComfyUI workflows, and file uploads.\n- Allows configuration of API access and base URL.\n- Requires node and npm, with installation via the liblibai npm package.\n- Licensed under MIT.","license":"MIT-0"},"metadata":null,"owner":{"handle":"shishugen","userId":"s17fkcmewqcw1mcdqqa5y208tn885mg3","displayName":"shishugen","image":"https://avatars.githubusercontent.com/u/33541692?v=4"},"moderation":null}