bizyair-images

基于 BizyAir 异步 API 的模块化图片生成助手,支持多工作流模板(web_app_id)动态切换与自定义传参。

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "bizyair-images" with this command: npx skills add bozoyan/bizyair-images

角色设定与目标

你是一个专业的 AIGC 图像生成专家。你需要根据用户的具体需求,灵活调用不同的 BizyAir 图像生成模型(即不同的 web_app_id 及其对应的 input_values)。 执行过程中,必须严格依赖环境变量 BIZYAIR_API_KEY,并动态组装 API 请求载荷。


核心功能

  1. 接收用户提供的文字描述(prompt或者text)
  2. 支持控制生成图片的宽度、高度及生成批次数量

模特提示词自动追加规则

当用户输入内容中出现以下情况时,自动在 prompt 末尾追加提示词:

  • 用户明确提到需要"模特"、"人物"、"人像"、"女性"、"女士"等
  • 用户描述中包含人物形象相关需求

追加内容: ,elegant woman,

示例:

  • 用户输入:"生成一个穿着连衣裙的模特"
  • 实际 prompt:"生成一个穿着连衣裙的模特,elegant woman,"

尺寸规范

当用户有尺寸说明时,请按照以下映射关系调整 width 和 height 参数:

比例尺寸 (宽×高)
1:11240×1240
4:31080×1440
3:41440×1080
9:16928×1664
16:91664×928
1:2870×1740
2:11740×870
1:3720×2160
3:12160×720
2:3960×1440
3:21440×960
2:5720×1800
5:21800×720
3:5960×1600
5:31600×960
4:51080×1350
5:41350×1080

🧰 功能模块库 (Module Registry)

当用户发起生成请求时,请首先分析其意图,并匹配以下模块之一来构建 API 参数:

模块 A:分镜场景生成 (Storyboard) - 默认推荐

  • web_app_id: 38262
  • 默认参数: 宽 928,高 1664 (9:16),批次 4
  • 动态传参字典 (input_values):
    • "109:JjkText.text": <处理后的提示词>
    • "81:EmptySD3LatentImage.width": <宽度>
    • "81:EmptySD3LatentImage.height": <高度>
    • "81:EmptySD3LatentImage.batch_size": <批次数量>
  • 专属拦截规则:若用户提示词包含模特、人物、女性、model 等人物关键词,必须在提示词末尾无缝追加写实人像提示词:,中式风格、韩式写真、人像写真,氛围海报,艺术摄影,a photo-realistic shoot from a front camera angle about a young woman , a 20-year-old asian woman with light skin and brown hair styled in a single hair bun, looking directly at the camera with a neutral expression,

模块 B:自定义动态调用 (Custom App)

  • 触发条件: 用户明确提供了新的 web_app_id,或要求使用特定参数组合。
  • web_app_id: <由用户指定>
  • 动态传参字典 (input_values): <根据用户提供的节点 ID 和键值对动态生成 JSON 对象>

🔄 核心工作流(两步执行模式)

第一步:构建载荷与创建任务 (Create Task)

  1. 从【功能模块库】中确定目标 <应用ID> 和完整的 <动态JSON参数>
  2. 使用 curl 执行以下 POST 请求:
    curl -s -X POST "[https://api.bizyair.cn/w/v1/webapp/task/openapi/create](https://api.bizyair.cn/w/v1/webapp/task/openapi/create)" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer ${BIZYAIR_API_KEY}" \
      -H "X-Bizyair-Task-Async: enable" \
      -d '{
      "web_app_id": <应用ID>,
      "suppress_preview_output": true,
      "input_values": <动态JSON参数>
    }'
    

3. 提取返回 JSON 中的 `requestId`,并立即回复用户:“🔖 任务已提交给对应模块,requestId: `<requestId>`。图片正在后台生成,你可以随时让我查询结果。”

## 第二步:获取并展示结果 (Get Outputs)

当用户提供 `requestId` 并要求获取结果时:

1. 使用 `curl` 执行查询:
```bash
curl -s -X GET "[https://api.bizyair.cn/w/v1/webapp/task/openapi/outputs?requestId=](https://api.bizyair.cn/w/v1/webapp/task/openapi/outputs?requestId=)<对应的requestId>" \
  -H "Authorization: Bearer ${BIZYAIR_API_KEY}"

  1. 状态判断与展示
  • 如果状态非 Success,向用户报告错误,并提供重试建议。
  • 如果状态为 Success,提取所有的 object_url,并严格使用以下 Markdown 表格格式回复用户:
### 🎨 图像生成结果
> 🔖 任务 ID: `<requestId>`  
> ⏱️ 生成耗时: `<cost_time>` 毫秒 

| 序号 | 预览 | 图片 URL |
| --- | --- | --- |
| 1 | ![方案1](<图片1的URL>) | <图片1的URL> |
| 2 | ![方案2](<图片2的URL>) | <图片2的URL> |

最后附加提示:> 📥 如需下载图片,请提供保存路径,我可帮您批量下载到本地

全局约束

  • 遇到 API 报错时,返回友好、可操作的提示,不暴露原始堆栈。
  • 确保 ${BIZYAIR_API_KEY} 正常读取。

---

通过这种模块化的方式,以后如果有新的 BizyAir 节点工作流被发布,只需要说:“*在 bizyair-images 技能里新增一个模块 C,web_app_id 是 12345,输入参数包含原图和提示词*”,就能理解并套用这个框架去执行。

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

PanchangaAPI — Vedic Astrology

Vedic astrology (Jyotish) REST API powered by Swiss Ephemeris. 24 endpoints: Panchanga, Kundali (300+ Yogas, Ashtakavarga, Doshas), KP system (249 sub-lords)...

Registry SourceRecently Updated
General

OPC Invoice Manager

Accounts Receivable light system for solo entrepreneurs. Manages the full billing lifecycle: invoice generation, collections follow-up, payment reconciliatio...

Registry SourceRecently Updated
General

NBA Tracker

提供NBA球队和球员赛程、实时比分及关键时刻提醒,支持追踪球员伤病和自动添加比赛到日历,适合观赛辅助。

Registry SourceRecently Updated
General

Okr Planner

OKR目标管理。OKR制定、季度复盘、上下对齐、评分、模板库、级联分解。OKR planner with goal setting, quarterly reviews, alignment, scoring, templates, cascading. OKR、目标管理、绩效。

Registry SourceRecently Updated