BizyAir Banana 2 图像生成

直接调用 BizyAir API，使用 Nano Banana 2 模型生成高质量图片。

前置要求

1. 注册 BizyAir 账号

• 访问 https://www.bizyair.cn 注册账号

2. 获取 API Key

• 登录后进入控制台复制 API Key

3. 配置 API Key（二选一）

方式 A：环境变量

export BIZYAIR_API_KEY="your_api_key_here"

方式 B：创建配置文件（推荐）

在技能目录创建 .env 文件：

# 技能目录/.env
BIZYAIR_API_KEY=your_api_key_here

配置文件位置优先级：

1. 技能目录下的 .env（推荐，通用）
2. ~/.config/bizyair-banana2/.env
3. ~/.bizyair-banana2/.env
4. ~/.baoyu-skills/bizyair-banana2/.env（兼容旧版本）

使用方法

基础用法 - 文生图

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  --prompt "一只可爱的猫咪" \
  --image cat.png

使用参考图（图生图）

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  --prompt "近景构图，自信展示自我，姿态酷飒随性" \
  --image output.png \
  --ref input.png

多张参考图

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  --prompt "图 1 的人穿着图 2 的衣服，在图 3 的场景中" \
  --image output.png \
  --ref person.png \
  --ref clothes.png \
  --ref background.png

指定宽高比

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  --prompt "全身照" \
  --image fullbody.png \
  --ar 9:16

表情包生成（Web App 47091）

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  --prompt "搞笑表情" \
  --image emoji.png \
  --ref portrait.jpg \
  --web-app-id 47091

命令行选项

环境变量

计费说明

• 按量付费，生成成功才扣费
• 具体价格：https://docs.bizyair.cn/pricing/introduce.html

API 参考

• 任务提交：POST /w/v1/webapp/task/openapi/create
• 状态查询：GET /w/v1/webapp/task/openapi/detail?requestId={id}
• 结果获取：GET /w/v1/webapp/task/openapi/outputs?requestId={id}
• 文件上传：GET /x/v1/upload/token

错误处理

示例工作流

示例 1：生成头像

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  -p "可爱的卡通女孩头像，粉色头发，大眼睛" \
  --image avatar.png \
  --ar 1:1

示例 2：生成表情包（使用参考图）

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  -p "搞笑表情，九宫格" \
  --image meme.png \
  --ref portrait.jpg \
  --web-app-id 47091

示例 3：多参考图融合

python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
  -p "图 1 的人穿着图 2 的衣服，在图 3 的场景中" \
  --image fusion.png \
  --ref person.png \
  --ref clothes.png \
  --ref background.png \
  --ar 9:16

示例 4：批量生成

for i in {1..5}; do
  python3 ${SKILL_DIR}/scripts/bizyair_gen.py \
    -p "赛博朋克风格城市夜景" \
    --image cyber_$i.png \
    --ar 16:9
done

参考资料

• BizyAir 官网
• BizyAir 文档
• API 参考
• 工作流广场
• 模型广场

故障排查

1. 检查 API Key

# 方式 1：检查技能目录的.env
cat /path/to/skills/bizyair-banana2/.env

# 方式 2：检查用户目录配置
cat ~/.config/bizyair-banana2/.env
cat ~/.bizyair-banana2/.env

2. 运行测试

cd /home/admin/.openclaw/workspace/skills/bizyair-banana2
bash test.sh

3. 常见错误

限制

• 图片生成需通过内容审核
• 参考图大小不超过 10MB
• 支持格式：PNG, JPG, WEBP