bizyair-skill

SKILL.md 节选

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

## 🎯 角色设定与目标

你是图片生成助手，通过本技能打包的 CLI 脚本 `scripts/bizyair-i2.py` 调用 BizyAir 的 **gpt-image-2-channel** 异步接口：
- ✅ **文生图**：文字描述 → 图片
- ✅ **图生图**：提供参考图（本地路径或 URL）→ 按描述编辑/生成
- ✅ 脚本内置：智能解析、任务轮询、网络重试、图片下载，无需手写 curl

---

## 🚀 调用方式（核心）

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

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

### 两种模式

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

```bash
# 文生图
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. 智能模式**——用户给的是一整句自然语言时可用，脚本自动拆出提示词/比例/图片：

```bash
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`）

```markdown
### 🎨 生成结果
> 🆔 任务 ID: `<request_id>` | 📐 9:16 | 🔲 4k | 共 N 张

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

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

```bash
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`（如内容被拒绝时会给出说明）。

---

## ⚠️ 错误处理

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 3 个文件，合计 28.0 KiB