批量上传文件
功能简介
批量并发上传多个文件到扣子编程。支持一次性上传多个文件，通过并发处理提高上传效率。上传完成后可在消息中通过文件 ID 在多模态内容中引用这些文件。
使用场景
- 需要一次性上传多个文件供智能体使用时
- 需要在对话中批量发送图片、文档等文件时
- 需要提高文件上传效率时
- 需要批量处理文件上传任务时
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 文件路径列表 | 列表 | 是 | 待上传文件的路径列表，每行一个文件路径。支持相对路径和绝对路径 |
| 并发数 | 整数 | 否 | 并发上传的文件数量，默认值为 5。建议根据套餐流控合理设置，不超过 10 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 上传结果 | 列表 | 是 | 列表格式，每项含文件路径、成功标记（success/fail）、文件 ID、错误信息，顺序与输入一致 |
注意事项
- 流控限制：上传文件的流控一般为 10～20 QPS（因套餐而异），建议并发数设为 5，不要超过 10，避免触发限流
- 文件大小限制：接口允许上传的最大文件大小为 512 MB；在与智能体对话时，实际可用大小还取决于智能体所用模型版本
- 上传方式：必须使用 multipart/form-data 方式上传文件
- 文件有效期：普通上传的文件将保存在扣子编程服务端，有效期为 3 个月。若上传的文件被用作扣子头像，则永久有效
- 使用限制：上传到扣子编程的文件仅限本账号查看或使用。不支持下载已上传的文件，用户仅可在对话、工作流、端插件、RTC 和 WebSocket 中通过文件 ID 访问和使用文件
- 支持格式：支持文档（DOC、DOCX、XLS、XLSX、PPT、PPTX、PDF、Numbers、CSV）、文本文件（CPP、PY、JAVA、C）、图片（JPG、PNG、GIF、WEBP、HEIC、HEIF、BMP、PCD、TIFF）、音频（WAV、MP3、FLAC、M4A、AAC、OGG、WMA、MIDI）、视频（MP4、AVI、MOV、3GP、3GPP、FLV、WEBM、WMV、RMVB、M4V、MKV）、压缩文件（RAR、ZIP、7Z、GZ、GZIP、BZ2）等格式
- 错误处理：单个文件上传失败不会影响其他文件的上传，所有错误信息都会记录在返回结果中
- 并发控制：可根据实际上传情况调整并发数；若频繁出现限流相关错误，建议降低并发数