对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储SDK 参考Java数据处理视频处理创建视频转码模板（Java SDK）
复制全文
下载 pdf创建视频转码模板（Java SDK）
文档反馈
问问助手本文介绍如何通过 TOS Java SDK 创建视频转码模板。
注意事项
仅 Java SDK 2.9.8 及以上版本支持创建视频转码模板功能。
示例代码
// 创建视频转码模板
package org.example.PutVideoConvertTemplate;
import com.volcengine.tos.TOSV2;
import com.volcengine.tos.TOSV2ClientBuilder;
import com.volcengine.tos.TosClientException;
import com.volcengine.tos.TosServerException;
import com.volcengine.tos.comm.common.*;
import com.volcengine.tos.model.bucket.*;
import com.volcengine.tos.model.object.*;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
public class PutVideoConvertTemplateExample {
private static String base64String(String originalStr){
// 步骤1：将字符串转为字节数组（指定UTF-8，避免乱码）
byte[] originalBytes = originalStr.getBytes(StandardCharsets.UTF_8);
// 步骤2：Base64 编码（Basic 编码器）
byte[] encodedBytes = Base64.getEncoder().encode(originalBytes);
// 步骤3：将编码后的字节数组转为字符串
String encodedStr = new String(encodedBytes, StandardCharsets.UTF_8);
return encodedStr;
}
public static void main(String[] args) {
String endpoint = System.getenv("TOS_ENDPOINT");
String region = System.getenv("TOS_REGION");
String accessKey = System.getenv("TOS_ACCESS_KEY");
String secretKey = System.getenv("TOS_SECRET_KEY");
// 填写 BucketName
String bucketName = System.getenv("TOS_BUCKET");
// 初始化客户端
TOSV2 tos = new TOSV2ClientBuilder().build(region, endpoint, accessKey, secretKey);
try {
// 设置转码时间区间，从视频第 0 秒开始，持续 10 秒
// 说明：start 表示起始时间，duration 表示持续时长，单位均为毫秒
TimeInterval timeInterval = TimeInterval.builder()
.start(0)
.duration(10000)
.build();
// 配置输出容器：使用 MP4 格式
Container container = Container.builder()
.format(ContainerFormatType.MP4)
.build();
// 配置视频编码参数：
Video video = Video.builder()
.codec("h264")
// - 编码格式：h264
.width(1920)
// - 分辨率：1920x1080（全高清）
.height(1080)
// - CRF：23（质量与码率折中）
.crf(23)
// - 像素格式：yuv420p
.pixFmt("yuv420p")
// - 码率：4 Mbps
.bitRate(4_000_000)
// - 帧率：30 fps
.fps(30)
.remove(false)
.build();
// 配置音频编码参数：
Audio audio = Audio.builder()
// - 编码格式：mp3
.codec("mp3")
.bitRate(128_000)
// - 采样格式：fltp
.sampleFormat("fltp")
// - 采样率：44100 Hz
.sampleRate(44_100)
// - 声道数：2（立体声）
.channels(2)
.remove(false)
.build();
// 配置 AIGC 元数据信息，用于标记内容生产与传播链路（示例值）
AIGCMetadata aigcMetadata = AIGCMetadata.builder()
.label("demo-label")
.contentProducer("demo-producer")
.produceID("demo-produce-id")
.contentPropagator("demo-propagator")
.propagateID("demo-propagate-id")
.reservedCode1(base64String("123abc"))
.reservedCode2(base64String("456def"))
.build();
// 通过 TranscodeConfigOptions 填充元数据配置
TranscodeConfigOptions options = TranscodeConfigOptions.builder()
.aigcMetadata(aigcMetadata)
.build();
// 汇总转码配置，将时间区间、容器、视频、音频以及 AIGC 元数据统一到 Transcode 中
Transcode transcodeConfig = Transcode.builder()
.timeInterval(timeInterval)
.container(container)
.video(video)
.audio(audio)
.options(options)
.build();
// 组装创建视频转码模板的输入参数：
// - bucket：模板所属存储桶
// - name：模板名称（示例为 example-video-template）
// - transcodeConfig：上述完整转码配置
PutVideoConvertTemplateInput input = PutVideoConvertTemplateInput.builder()
.bucket(bucketName)
.name("example-video-template")
.transcodeConfig(transcodeConfig)
.build();
// 调用 API 创建视频转码模板
PutVideoConvertTemplateOutput output = tos.putVideoConvertTemplate(input);
// 打印关键返回结果，便于排查与确认：
// - RequestID：请求在服务端的唯一标识
// - StatusCode：HTTP 状态码
// - 模板 ID：后续创建转码任务可直接引用的模板标识
System.out.println("创建视频转码模板成功");
System.out.println("RequestID: " + output.getRequestInfo().getRequestId());
System.out.println("StatusCode: " + output.getRequestInfo().getStatusCode());
System.out.println("模板ID: " + output.getId());
} catch (TosClientException e) {
// 操作失败，捕获客户端异常，一般情况是请求参数错误，此时请求并未发送
System.out.println("操作失败");
System.out.println("Message: " + e.getMessage());
if (e.getCause() != null) {
e.getCause().printStackTrace();
}
} catch (TosServerException e) {
// 操作失败，捕获服务端异常，可以获取到从服务端返回的详细错误信息
System.out.println("操作失败");
System.out.println("StatusCode: " + e.getStatusCode());
System.out.println("Code: " + e.getCode());
System.out.println("Message: " + e.getMessage());
System.out.println("RequestID: " + e.getRequestID());
} catch (Throwable t) {
// 作为兜底捕获其他异常，一般不会执行到这里
System.out.println("操作失败");
System.out.println("unexpected exception, message: " + t.getMessage());
}
}
}
相关文档
最近更新时间：2026.08.12 10:48:48
这个页面对您有帮助吗？
有用
有用
无用
无用