功能简介

批量并发上传多个文件到扣子编程。支持一次性上传多个文件，通过并发处理提高上传效率。上传完成后可在消息中通过文件 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）等格式

错误处理：单个文件上传失败不会影响其他文件的上传，所有错误信息都会记录在返回结果中

并发控制：可根据实际上传情况调整并发数；若频繁出现限流相关错误，建议降低并发数