BizyAir 文件上传助手

本技能帮助你将本地文件（图片、音频、视频等）上传到 BizyAir 服务器，并获取可访问的 URL。

功能

• 📤 上传本地文件到 BizyAir 服务器
• 🔗 获取可访问的资源 URL
• 📋 查询已上传的输入资源列表

前置准备

1. 获取 API Key：访问 BizyAir 控制台 获取 API Key
2. 配置环境变量（推荐）：

```bash

export BIZYAIR_API_KEY="your_api_key_here"

```

使用方法

上传单个文件

当用户需要上传文件时：

请帮我把 /path/to/image.png 上传到 BizyAir

或者：

上传这张图片到 BizyAir 并获取 URL

批量上传

上传这些文件到 BizyAir：
- image1.png
- image2.jpg
- video.mp4

查询已上传资源

查看 BizyAir 中的输入资源列表

上传流程

技能会自动完成以下步骤：

1. 获取上传凭证 - 从 BizyAir API 获取临时 STS 凭证和 OSS 上传参数
2. 上传到 OSS - 使用阿里云 OSS SDK 将文件上传到指定存储
3. 提交资源 - 在 BizyAir 系统中注册该资源
4. 返回 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>]

使用效果

!第一次使用配置，会有很多提示。

!第二次快很多，和它说列出 URL 就可以。