前言¶
在 Cursor、Claude Code 等环境里做配图，常见做法是手写 curl 调异步 API、自己轮询任务、再把图片 URL 整理给用户。BizyAir 的 gpt-image-2-channel 接口本身也是任务制，参数（比例、分辨率、参考图）一多，对话里很容易漏步骤或超时。
下面介绍 SkillHub 上的 bizyair Skill：把提交、轮询、下载封装进 bizyair-i2.py，Agent 按 SKILL.md 约定解析用户意图并调用脚本即可。与「只记几个 REST 端点」相比，它更贴近「在 IDE 里说一句就出图」的工作流。
这是什么¶
bizyair 是发布在 SkillHub 的 Agent Skill（@indiv-bozoyan/bizyair，作者 bozoyan，用户标识 user_6419d865），当前版本 v1.0.1。
SkillHub 列表简介为：BizyAir 图片/视频/音频生成与 AI 应用执行；用户提到 BizyAir、要生成图片视频、发来 BizyAir 链接或 ID、要搜索 BizyAir 应用时调用。SkillHub 分类为 design-media，子类包含图片生成、视频处理、音频处理；技能标签标明需要 API Key（requires_api_key）。
就本版本安装包内的 SKILL.md 而言，实现重心是 gpt-image-2-channel 的文生图与图生图，通过技能目录下的 CLI 完成，而不是在对话里拼裸 HTTP。
官方入口：
- SkillHub 页面：https://skillhub.cn/skills/indiv-bozoyan/bizyair
- API 地址（Skill 线索）：https://api.skillhub.cn/user_6419d865/bizyair
核心功能¶
以下能力均来自已安装的 v1.0.1 包内 SKILL.md 与 scripts/bizyair-i2.py。
文生图与图生图¶
- 文生图：自然语言提示词生成图片。
- 图生图：最多 10 张参考图（本地路径或 URL），按提示词编辑或再生成。
- 两种调用模式：精确模式（
--prompt、--ar等）与智能模式（-t整句自然语言，脚本自动拆提示词、比例、图片路径）。
异步任务与落盘¶
脚本对接 https://api.bizyair.ai 上的 gpt-image-2-channel 端点，流程为：提交任务拿到 request_id → 先等待 40 秒再每 5 秒轮询（最长 600 秒）→ 将结果下载到 --output（默认 ./output），文件名形如 bizyair_时间戳_序号.png。可选 --no-save 仅输出 URL。
参数与默认值¶
- 比例
--ar：14 种固定值（如1:1、16:9、9:16等），未指定时默认16:9。 - 分辨率
-r/--resolution：1k/2k/4k，默认 4k。 - 新接口按比例出图，不支持自定义像素宽高与
batch_size（文档中旧版像素表已废弃）。
触发条件（Agent 何时应加载本 Skill）¶
当用户提到「生成图片」「画一张」「出图」「文生图」「图生图」「BizyAir」「gpt-image」等，或未指定其他生图工具时的「AI 生图」需求，应按 Skill 说明优先使用本技能。
海报模板（可选）¶
用户要蓝白简约动漫风海报、关键词海报等时，可读取包内 references/anime-poster-template.md 搭提示词，再调用脚本（文档建议固定 --ar 9:16 --resolution 4k）。
安装与启用¶
通过 SkillHub 安装（推荐）¶
SkillHub 页面给出的安装话术为：先阅读安装说明，再安装指定技能包。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@indiv-bozoyan/bizyair`。
若本机已有 skillhub CLI，需把技能装到当前 Agent 的 skills 目录（否则默认 ./skills/ 可能不会被识别）。示例：
command -v skillhub && skillhub --version
skillhub install bizyair --dir ~/.cursor/skills/
常见 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
未安装 CLI 时，可按 https://skillhub.cn/install/skillhub.md 使用官方 install.sh 安装；具体命令以该文档为准。
运行依赖¶
SKILL.md front matter 要求：
- Python 3，用于运行
scripts/bizyair-i2.py - pip：
requests、python-dotenv；参考图为本地文件时另需alibabacloud_oss_v2
API Key 通过环境变量 BIZYAIR_API_KEY 提供；文档说明可从 ~/.hermes/.env 等来源读取（以你本机实际配置为准）。
pip install requests python-dotenv
# 本地参考图上传时：
pip install alibabacloud_oss_v2
export BIZYAIR_API_KEY=你的密钥
在 BizyAir 账号侧创建 API 密钥的步骤，以 BizyAir 官方站点说明为准（SkillHub 仅标注需要 Key，未在包内展开注册流程）。
典型用法¶
将 <SKILL_PATH> 替换为安装后的技能目录绝对路径。Agent 调用 Bash 时，建议超时设为 600000 ms（10 分钟），避免 4k 出图轮询被提前终止。
文生图（精确模式）¶
python3 <SKILL_PATH>/scripts/bizyair-i2.py --prompt "一只猫在窗台晒太阳" --ar 1:1
图生图（本地或 URL 参考图）¶
python3 <SKILL_PATH>/scripts/bizyair-i2.py -p "把背景换成雪山" \
-i /path/to/photo.png -i https://example.com/ref.jpg --ar 16:9
自然语言整句（智能模式）¶
python3 <SKILL_PATH>/scripts/bizyair-i2.py -t "在这张图里画只猫，9:16，/path/to/ref.png"
查询历史任务（可选）¶
用户持有 request_id 时，可用文档中的 OpenAPI 查询（需 Bearer Token）：
curl -s -H "Authorization: Bearer $BIZYAIR_API_KEY" \
"https://api.bizyair.ai/v1/modelzoo/tasks/openapi/<request_id>"
status 为 Pending / Running / Saving / Success / Failed；成功时图片在 data.outputs.images。
向用户展示时，Skill 要求用 Markdown 图片语法、表格列出预览与本地路径，并附上 request_id。
适用场景与注意¶
适合谁：已在 BizyAir 开通算力与 API Key，希望在 Cursor 等 Agent 里用自然语言出图、改图，又不想每次手写轮询逻辑的团队或个人。
使用上要注意：
- 计费：每次运行消耗 BizyAir 账户余额，Agent 应在用户确认需求与参数后再执行脚本。
- 耗时：单次常见 1–3 分钟，4k 更久；轮询超时后可用
request_id查询，避免重复提交。 - 网络：脚本内置
NO_PROXY='*'直连api.bizyair.ai；文档提示本机系统代理可能导致 503，勿额外叠代理环境变量。 - 简介与包内能力：SkillHub 中文简介覆盖更广的 BizyAir 场景；v1.0.1 包内文档与脚本仅实现 gpt-image-2-channel 图片链路。若你需要视频、音频或「搜索 BizyAir 应用」等能力，需对照 SkillHub 是否有更新版本或其它 Skill，勿默认本包已全部覆盖。
- 安全扫描：SkillHub 详情页展示的安全报告状态为「安全，无风险」（具体报告链接以页面为准）。
结尾¶
bizyair 把 BizyAir gpt-image-2-channel 的异步出图流程收成一条 CLI，并写清 Agent 的触发条件、参数与展示格式，适合在 IDE 里做文生图、图生图与海报类需求。安装与元数据以 SkillHub 为准：
https://skillhub.cn/skills/indiv-bozoyan/bizyair
https://api.skillhub.cn/user_6419d865/bizyair
