| name | bizyair-upload |
| description | BizyAir 文件上传助手。当用户需要将本地图片、音频、视频等资源上传到 BizyAir 服务器时使用此技能。支持快速上传并获取可访问的 URL。触发场景：用户提到"上传到 BizyAir"、"BizyAir 上传"、"上传图片到 BizyAir"，或者需要获取 BizyAir input resource URL 时。 |
BizyAir 文件上传助手
本技能帮助你将本地文件（图片、音频、视频等）上传到 BizyAir 服务器，并获取可访问的 URL。
功能
- 📤 上传本地文件到 BizyAir 服务器
- 🔗 获取可访问的资源 URL
- 📋 查询已上传的输入资源列表
前置准备
- 获取 API Key：访问 BizyAir 控制台 获取 API Key
- 配置环境变量（推荐）：
export BIZYAIR_API_KEY="your_api_key_here"
使用方法
上传单个文件
当用户需要上传文件时：
请帮我把 /path/to/image.png 上传到 BizyAir
或者：
上传这张图片到 BizyAir 并获取 URL
批量上传
上传这些文件到 BizyAir：
- image1.png
- image2.jpg
- video.mp4
查询已上传资源
查看 BizyAir 中的输入资源列表
上传流程
技能会自动完成以下步骤：
- 获取上传凭证 - 从 BizyAir API 获取临时 STS 凭证和 OSS 上传参数
- 上传到 OSS - 使用阿里云 OSS SDK 将文件上传到指定存储
- 提交资源 - 在 BizyAir 系统中注册该资源
- 返回 URL - 返回可访问的资源 URL
输出示例
上传成功后会返回：
✅ 上传成功！
文件名: example.png
URL: https://storage.bizyair.cn/inputs/20250911/xxx.png
Object Key: inputs/20250911/xxx.png
错误处理
- API Key 未配置：提示用户设置
BIZYAIR_API_KEY 环境变量或在对话中提供
- 文件不存在：检查文件路径是否正确
- 上传失败：显示详细错误信息，可能是网络问题或凭证过期
- 文件类型不支持：BizyAir 支持常见图片、音频、视频格式
注意事项
- STS 凭证是临时的，仅用于上传环节
- 上传后的 URL 可用于 BizyAir 工作流中的 LoadImage、LoadAudio、LoadVideo 等节点
- 建议上传后尽快使用或保存 URL
脚本使用
如需直接使用上传脚本：
python scripts/upload.py <file_path> [--api-key <key>]
使用效果
