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

Google Meet

Google Meet API integration with managed OAuth. Create meeting spaces, list conference records, and manage meeting participants. Use this skill when users wa...

Registry SourceRecently Updated
16.9K15byungkyu
General

API Changelog Generator

Generate and maintain API changelogs from OpenAPI/Swagger specs — track endpoints added, removed, deprecated, or modified between versions. Detect breaking c...

Registry SourceRecently Updated
General

Incident Response Runbook

Create, maintain, and execute detailed incident response runbooks to guide triage, communication, and post-incident reviews for production outages.

Registry SourceRecently Updated
General

Procore

Procore integration. Manage Projects, Users, Roles, Organizations. Use when the user wants to interact with Procore data.

Registry SourceRecently Updated