功能描述

此接口用于对音视频文件进行转封装处理。

注意事项

音视频文件转封装任务仅支持异步处理，推荐使用 Job 模式。

使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateMediaProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
job_type	Query	String	是	Remux	任务类型，转封装场景下取值仅为 emux。
media_jobs	Query	String	是	-	代表媒体任务的请求特殊标识。

请求元素

名称	参数类型	是否必填	示例值	说明
Input	Container	是	-	待转封装的源文件信息。
Object	String	是	sample.mp4	源音视频文件的对象名（Key）。源对象所在存储桶即发起请求的 BucketName。缺省时任务会创建成功但执行失败。父节点：Input
RemuxConfig	Container	是	-	转封装任务具体配置。
Format	String	是	mp4	音视频封装格式。支持格式如下： mp4 mkv avi mkv ts mp3 aac flac 父节点：RemuxConfig
Duration	Integer	否	5000	HLS 分片时长，仅当 Format 为 hls 时有效；单位毫秒，默认值为 5000，取值范围为 [0, 3600000]。父节点：RemuxConfig
TranscodeIndex	String	否	0	处理的流编号，指定后目的文件将只保留指定的音视频流。默认处理所有流。父节点：RemuxConfig
AIGCMetadata	Container	否	-	AIGC 元数据标识内容。不为 nil 时封装格式仅支持 mp4、mp3、oga、flac、m4a、opus； AIGCMetadata 下所有字段长度限制为 2048 个 UTF-8 字符数，字符限制为 ASCII 码位为 0x21 - 0x7E 的字符。父节点：RemuxConfig
Label	String	是	test_label	生成合成标签要素，用于表示视频属于、可能、疑似为人工智能生成合成的属性信息。父节点：AIGCMetadata
ContentProducer	String	是	test_content_producer	生成合成服务提供者要素，内容为视频生成合成服务提供者的名称或编码。父节点：AIGCMetadata
ProduceID	String	是	test_produce_id	内容制作编号要素，内容为视频生成合成服务提供者对该内容的唯一编号。父节点：AIGCMetadata
ContentPropagator	String	否	test_content_propagator	内容传播服务提供者要素，内容为视频传播服务提供者的名称或编码。父节点：AIGCMetadata
PropagateID	String	否	test_propagate_id	内容传播编号要素，内容为视频传播服务提供者对该视频的唯一编号。父节点：AIGCMetadata
ReservedCode1	String	否	dGVzdF9yZXNlcnZlZF9jb2RlXzE=	预留字段 1，内容为用户自主开展安全防护，保护内容、标识完整性的信息。需经过 base64 编码后传入。父节点：AIGCMetadata
ReservedCode2	String	否	dGVzdF9yZXNlcnZlZF9jb2RlXzI=	预留字段 2，内容为用户自主开展安全防护，保护内容、标识完整性的信息。需经过 base64 编码后传入。父节点：AIGCMetadata
C2PAMetadata	Container	否	-	C2PA 元数据。父节点：RemuxConfig
AppID	String	是	536335	业务方在云签平台申请的 AppID。父节点：C2PAMetadata
Manifest	Object	是	-	C2PA Manifest 内容，必须为合法 JSON 对象。父节点：C2PAMetadata
Output	Container	是	-	转封装结果的输出位置。
Region	String	是	cn-beijing	输出存储桶所在地域，须与源存储桶处于同一地域，否则返回 srcBucket and dstBucket should in same region。父节点：Output
Bucket	String	是	testbkt	输出结果写入的目标存储桶名称。缺省时返回 output bucket is empty。父节点：Output
Object	String	是	output.mp4	输出结果的对象名。父节点：Output

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。
Message	String	Success	请求状态信息。
JobId	String	187919df106a49aa402300013e6b********	音视频转封装任务 ID。

请求示例

响应示例

对象存储