在火山引擎tos上传视频需先开通服务、创建bucket并配置权限，再通过控制台（单文件，≤5gb，无断点续传）、命令行（批量，支持断点续传与分片）、sdk（集成业务，含进度回调与md5校验）三种方式上传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在火山引擎TOS中上传视频文件，需先完成对象存储服务开通、Bucket创建及权限配置，再通过控制台、命令行工具或SDK三种方式完成上传，其中控制台适合单文件快速上传，命令行适合批量上传，SDK适合集成到业务系统中。
开通TOS服务并创建Bucket
进入火山引擎控制台 → 选择「对象存储 TOS」→ 点击「立即开通」→ 开通成功后点击「创建 Bucket」。
填写 Bucket 名称（全局唯一，仅支持小写字母、数字、短划线，且必须以字母开头）、选择地域（建议与业务服务器同地域以降低延迟）、设置读写权限（生产环境【强烈建议选“私有读写”】，避免视频被未授权访问）→ 点击「确定创建」。
创建完成后，在 Bucket 列表中找到该 Bucket，点击进入管理页面——这是后续所有上传操作的起点。
通过控制台上传单个视频文件
在目标 Bucket 的管理页 → 点击「上传文件」按钮 → 在弹窗中点击「选择文件」，从本地选取一个视频文件（支持 MP4、MOV、AVI 等常见格式，单文件最大 5 GB）→ 确认文件名无误（Key 将作为该视频在 TOS 中的唯一路径标识）→ 点击「开始上传」。
上传进度条走完即完成。注意：控制台上传不支持断点续传，若网络中断需重新上传整个文件。
使用tosutil命令行工具批量上传视频
方法一：安装并配置 tosutil
下载对应系统版本的 tosutil 工具（Linux/macOS/Windows 均支持），解压后将二进制文件加入系统 PATH；执行 tosutil configure，按提示输入 AccessKey ID、AccessKey Secret、Region（如 cn-beijing）、Endpoint（如 https://tos-cn-beijing.volces.com）。
方法二：执行上传命令
假设本地视频存放在 /videos/ 目录下，要上传至 Bucket my-video-bucket 的 raw/ 前缀路径：
tosutil cp /videos/*.mp4 tos://my-video-bucket/raw/ --recursive --part-size 10485760
该命令启用分片上传（【--part-size 10MB 是关键参数，避免大文件内存溢出】），自动跳过已存在且 MD5 一致的文件，支持断点续传。上传完成后可在控制台确认文件列表和大小是否匹配。
用 Java SDK 实现视频上传（含进度回调）
第一步：Maven 引入依赖
<dependency><groupid>com.volcengine</groupid><artifactid>tos-java-sdk</artifactid><version>1.5.0</version></dependency>
第二步：初始化客户端并上传
创建 TosClient 实例时，必须传入 Region 和 Endpoint，二者必须严格匹配（例如 cn-beijing 地域对应 endpoint https://tos-cn-beijing.volces.com，填错会导致连接拒绝）。
第三步：调用 putObject 方法
传入 Bucket 名、Object Key（如 videos/20260804/intro.mp4）、本地文件路径；若需监控进度，可实现 ProgressListener 接口并在上传时传入——这对上传数 GB 视频时判断卡顿或失败非常必要。
第四步：校验上传结果
SDK 返回 PutObjectResult 对象，检查其 eTag 字段（即文件 MD5 值）是否与本地计算一致，确保视频未损坏。此步不可跳过，尤其在弱网环境下。
