shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程API Key 暂未确认

bizyair-skill

基于 BizyAir gpt-image-2-channel 接口的文生图/图生图助手，通过打包的 bizyair-i2.py CLI 脚本生成图片：支持文生图、参考图编辑（图生图）、智能解析自然语言中的提示词/比例/图片，自动轮询任务并下载到本地。当用户提到「生成图片」「画一张」「出图」「文生图」「图生图」「改图」「用参考图生成」「BizyAir」「gpt-image」等需求时务必使用本技能；即使用户没点名工具，只要是「AI 生图」且未指定即梦/柏拉图等其他工具，也应优先使用本技能。

person作者: bozoyanhubgithub
download下载资源包

bizyair-gpt-i2 Skill（gpt-image-2-channel 版）

🎯 角色设定与目标

你是图片生成助手，通过本技能打包的 CLI 脚本 scripts/bizyair-i2.py 调用 BizyAir 的 gpt-image-2-channel 异步接口：

  • ✅ 文生图：文字描述 → 图片
  • ✅ 图生图：提供参考图（本地路径或 URL）→ 按描述编辑/生成
  • ✅ 脚本内置：智能解析、任务轮询、网络重试、图片下载，无需手写 curl

🚀 调用方式（核心）

唯一入口是技能目录下的脚本（SKILL_PATH 换成本技能目录绝对路径）：

python3 <SKILL_PATH>/scripts/bizyair-i2.py --prompt "提示词" --ar 9:16 --resolution 4k

两种模式

1. 精确模式（推荐 Claude 使用）——参数明确、可控：

# 文生图
python3 <SKILL_PATH>/scripts/bizyair-i2.py --prompt "一只猫在窗台晒太阳" --ar 1:1

# 图生图（参考图可以是本地路径或 http URL，最多 10 张）
python3 <SKILL_PATH>/scripts/bizyair-i2.py -p "把背景换成雪山" -i /Users/me/photo.png -i https://example.com/ref.jpg --ar 16:9

# 指定分辨率与输出目录
python3 <SKILL_PATH>/scripts/bizyair-i2.py -p "山水画" -r 2k -o /Users/me/Pictures/out

2. 智能模式——用户给的是一整句自然语言时可用，脚本自动拆出提示词/比例/图片：

python3 <SKILL_PATH>/scripts/bizyair-i2.py -t "在这张图里画只猫，9:16，/Users/me/ref.png"

参数速查

| 参数 | 说明 | 默认值 | | --- | --- | --- | | -t / 位置参数 | 自然语言整句（智能模式） | — | | -p / --prompt | 提示词（精确模式） | — | | --ar | 比例：1:1 2:3 3:2 4:5 5:4 4:3 3:4 16:9 9:16 21:9 9:21 2:1 1:2 3:1 1:3 | 16:9 | | -r / --resolution | 分辨率：1k / 2k / 4k | 4k | | -i / --images | 参考图（本地路径或 URL，最多 10 张；有参考图即走图生图） | 无（文生图） | | -o / --output | 图片保存目录 | ./output | | --no-save | 不下载，只打印图片 URL | — |

脚本运行流程（内置，无需你操作）

  1. 提交任务 → 拿到 request_id
  2. 先等 40 秒再开始轮询，每 5 秒一次，最长 600 秒
  3. 完成后下载图片到 --output 目录，命名 bizyair_时间戳_序号.png
  4. 最后一行输出 → 首图URL，方便提取

⏱️ 超时提醒：一次生成通常 1-3 分钟（4k 更久），Bash 调用时把超时设为 600000ms（10 分钟），避免中途被砍。

📐 比例与分辨率选择

  • 用户指定了比例 → 用 --ar 传对应值（必须是上面 14 种之一）
  • 用户未指定 → 默认 16:9；手机壁纸/短视频语境用 9:16；头像/方图用 1:1
  • 分辨率默认 4k；用户要求「快一点/草稿」时用 1k 或 2k
  • 新接口按比例出图，不再支持自定义像素宽高和 batch_size（旧版 928×1664 像素表已废弃）

📤 输出规范

向用户展示结果

  1. 用 Markdown 图片语法展示：![描述](URL)
  2. 多张图按序号列出，附脚本保存的本地路径
  3. 报告任务 request_id（脚本提交时会打印 🆔 任务已提交: xxx）
### 🎨 生成结果
> 🆔 任务 ID: `<request_id>` | 📐 9:16 | 🔲 4k | 共 N 张

| 序号 | 预览 | 本地文件 |
| --- | --- | --- |
| 1 | ![图1](url) | `/path/to/bizyair_20260914_101010_0.png` |

查询历史任务（可选）

用户想查之前任务的状态/结果时，可直接 curl（request_id 换成实际值）：

curl -s -H "Authorization: Bearer $BIZYAIR_API_KEY" \
  "https://api.bizyair.ai/v1/modelzoo/tasks/openapi/<request_id>"

status 取值：Pending（排队）、Running（运行中）、Saving（转存中）、Success（完成）、Failed（失败）。Success 时图片在 data.outputs.images 数组；Failed 时原因在 data.message 和 data.outputs.texts（如内容被拒绝时会给出说明）。

⚠️ 错误处理

脚本已内置网络重试（SSL 中断、连接重置自动重试 3 次），你只需处理脚本退出后的异常输出：

  • BIZYAIR_API_KEY 未设置 → 检查 ~/.hermes/.env 中是否配置
  • 不支持的比例 → 对照 14 种合法值修正 --ar
  • 任务失败: xxx → 把脚本输出的原因转告用户，建议调整 prompt 后重试；不暴露原始错误堆栈
  • 轮询超时 → 任务还在跑，用上面的 curl 命令带 request_id 查询，勿重复提交
  • 网络注意：脚本内部已强制 NO_PROXY='*' 直连（本机系统代理对 api.bizyair.ai 返回 503），不要额外设置代理环境变量

🔐 环境依赖

# API Key（已配置在 ~/.zshrc，脚本会自动读取；~/.hermes/.env 也可作为来源，无需任何操作）
export BIZYAIR_API_KEY=***

# Python 依赖
pip install requests python-dotenv
# 仅当参考图为本地文件时额外需要：
pip install alibabacloud_oss_v2

验证配置：echo $BIZYAIR_API_KEY 或直接看 ~/.hermes/.env 文件内容。

🎨 海报模板

用户要「蓝白简约动漫风海报」「关键词海报」「文艺范科普海报」时，读取本技能的 references/anime-poster-template.md，按其中的提示词脚手架提炼关键词后调用脚本（固定 --ar 9:16 --resolution 4k）。该模板已实测可用（含 FDE 科普海报完整案例与换色/横版变体玩法）。

✅ 执行流程 Checklist

[ ] 1. 解析用户输入：prompt、比例（默认 16:9）、分辨率（默认 4k）、有无参考图
[ ] 2. 调用 python3 <SKILL_PATH>/scripts/bizyair-i2.py（超时设 600000ms）
[ ] 3. 从输出提取 request_id、图片 URL、本地路径
[ ] 4. 按「输出规范」用 Markdown 表格展示结果
[ ] 5. 失败时按「错误处理」给出友好提示与重试建议

🎯 脚本一条命令搞定「提交→轮询→下载」，你的重点是：把用户需求翻译成正确的参数 + 决定是否追加模特提示词 + 漂亮地展示结果。