## **功能描述** 此接口用于创建音视频转码模板。 ## **注意事项** * 单条规则 `body `最大不超过 20KB，最多允许配置 100 条自定义模板。 * 通过子账号使用时，需要授予当前桶的 `PutDataProcessTemplate` 权限。 ## **请求消息样式** ```JSON PUT /?process_template&tag=Transcode HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Tag": "Transcode", // 固定标识 "Name": "my-template", "TranscodeConfig": { "TimeInterval": { "Start": 0, "Duration": 10000, }, "Container": { "Format": "mp4" }, "Video": { "Codec": "h264", "Width": 480, "Height": 480, "Crf": 1, "PixFmt": "yuv420p" "BitRate": 3000000, "Fps": 24, "Remove": false }, "Audio": { "Codec": "aac", "BitRate": 128000, "SampleFormat": "fltp", "Channels": 2, "Remove": false }, "Options": { "AIGCMetadata": { "Label": "1", "ContentProducer": "test_producer", "ProduceID": "12345", "ContentPropagator": "test_propagator", "PropagateID": "12345", "ReservedCode1": "ewogICAgIm****UiLAp9", "ReservedCode2": "ewogICAg*****UyIiwKfQ" } } } } ``` ## **请求参数和消息头** |参数名称 |参数类型 |是否必填 |示例值 |说明 | |---|---|---|---|---| |process_template |String |是 |\- |视频转码模板标识。 | |Tag |String |是 |Transcode |任务类型，音视频转码场景下取值仅为 `Transcode`。 | ## **请求元素** |参数名称 |参数类型 |是否必填 |示例值 |说明 | |---|---|---|---|---| |Name |String |是|name |自定义模板名称：|\ | | | | ||\ | | | | |* 仅支持 `a-z`、`A-Z`、`0-9`、`_`、`-`和 `.`，长度不超过 64字符，必须以 `a-z`、`A-Z`、`0-9` 开头和结尾。|\ | | | | |* 多条规则不能重复。 | |TranscodeConfig |Container |是 |\- |音视频转码模板详情信息。 | |Transcode |Container |是 |\- |音视频转码模板详情信息。|\ | | | | |父节点：`TranscodeConfig`。 | |TimeInterval |Container |否 |\- |指定转码时长。|\ | | | | |父节点：`Transcode`。 | |Start |Integer |否 |0 | 开始时间，单位毫秒，默认值 0。|\ | | | | |父节点：`TimeInterval`。 | |Duration |Integer |否 |10000 |持续时间，单位毫秒，默认值 0 表示视频时长。|\ | | | | |父节点：`TimeInterval`。 | |Container |Container |是 |\- |指定转码容器格式。|\ | | | | |父节点：`Transcode`。 | |Format |String|是|mp4 |视频文件封装格式，取值列表如下：|\ | | | | ||\ | | | | |* `mp4`。|\ | | | | |* `ts`。|\ | | | | |* `hls`。|\ | | | | |* `mp3`|\ | | | | |* `aac`。|\ | | | | |* `flac`。|\ | | | | |* `m4a`。|\ | | | | |* `oga`。|\ | | | | |* `wav`。|\ | | | | |* `ac3`。|\ | | | | |* `opus`。|\ | | | | ||\ | | | | |父节点：`Container`。 | |ClipConfig |Container | 否 |\- |分片配置，指定` hls` 转码分片时长。|\ | | | | |父节点：`Container`。 | |Duration |Integer |否 |5000 |`hls` 转码的分片时长，单位毫秒，默认值为 5000，合法取值范围为 (0, 3600000)。|\ | | | | |父节点：`ClipConfig`。 | |Video |Container |是 |\- |视频编码参数。|\ | | | | |父节点：`Transcode`。 | |Codec |String |否 |H.264 |视频编解码格式，取值如下：|\ | | | | ||\ | | | | |* h264。|\ | | | | |* h265。|\ | | | | ||\ | | | | |父节点：`Video` 。 | |Width |Integer |否 |4096 |视频宽度，单位 `px`，必须为偶数，取值范围为 [128, 4096]。|\ | | | | |父节点：`Video` 。|\ | | | | |:::tip|\ | | | | |如果只设置 `Width `，未设置`Height`，将按照视频原始比例计算视频文件的高度。|\ | | | | ||\ | | | | |:::| |Height |Integer |否 |1024 |视频高度，单位 `px`，必须为偶数，取值范围为 [128, 4096]。|\ | | | | |父节点：`Video` 。|\ | | | | |:::tip|\ | | | | |如果只设置 `Height `，未设置`Width`，将按照视频原始比例计算视频文件的宽度。|\ | | | | ||\ | | | | |:::| |Crf |Integer |否 |25 |视频文件的码率控制因子，值范围 (0, 51]。|\ | | | | ||\ | | | | |* 默认 0 表示不设置。|\ | | | | |* 如果设置了 `Crf`，则 `Bitrate `的设置失效。|\ | | | | |* 当 Bitrate 为空时，按照编码器默认值。|\ | | | | ||\ | | | | |父节点：`Video` 。 | |PixFmt |String |否 |yuv420p |视频像素格式。|\ | | | | |父节点：`Video` 。 | |BitRate |Integer |否 |0 |视频输出文件的码率，单位 `bps`，值范围 [10000, 50000000]，默认 0 表示不设置。|\ | | | | |父节点：`Video` 。 | |Fps |Integer |否 |0 |视频帧率，单位 `fps`，值范围 (0, 60]，默认 0 表示不设置。|\ | | | | |父节点：`Video` 。 | |Remove |Bool |否 |false |是否删除源视频流，取值 `true `或 `false`。|\ | | | | |父节点：`Video` 。 | |Audio |Container |否 |\- |指定音频流参数。|\ | | | | |父节点：`Transcode`。 | |Codec |String |否 |aac|音频流编码格式，取值列表如下：|\ | | | | ||\ | | | | |* `mp3`。|\ | | | | |* `aac`。|\ | | | | |* `flac`|\ | | | | |* `Vorbis`。|\ | | | | |* `ac3`。|\ | | | | |* `opus`。|\ | | | | |* `pcm_s16le`。|\ | | | | ||\ | | | | |父节点：`Audio` 。|\ | | | | |:::tip|\ | | | | |不同容器格式支持的音频编码格式有所不同，详情请参见[不同容器的音频编码格式支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |BitRate |Integer |否 |128000 |音频码率，单位为比特/秒（bps），取值范围：1000~10000000。为0时使用原音频码率，部分容器不支持指定码率。|\ | | | | |父节点：`Audio` 。|\ | | | | |:::tip|\ | | | | |不同格式支持的声道数有所不同，详情请参见[不同音频容器参数支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |SampleFormat |String |否 |fltp |音频采样格式，不同容器取值范围不同。取值：|\ | | | | ||\ | | | | |* `fltp`。|\ | | | | |* `s16`。|\ | | | | |* `s16p`。|\ | | | | |* `s32`。|\ | | | | |* `s32p`。|\ | | | | ||\ | | | | |父节点：`Audio` 。 | |SampleRate |Integer |否 |48000 |音频采样率，不同容器取值范围不同。|\ | | | | |父节点：`Audio` 。|\ | | | | |:::tip|\ | | | | |不同格式支持的采样率有所不同，详情请参见[不同音频容器采样率支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |Channels |Integer |否 |2 |音频声道数，默认与指定的源音频一致，取值范围：1~8，不同容器取值范围不同。|\ | | | | |父节点：`Audio` 。|\ | | | | |:::tip|\ | | | | |不同格式支持的声道数有所不同，详情请参见[不同音频容器参数支持情况](https://www.volcengine.com/docs/6349/2038064?lang=zh#6b82ba91)。|\ | | | | ||\ | | | | |:::| |Remove |Bool | 否 |false |是否删除源音频流，取值 `true `或 `false`。|\ | | | | |父节点：`Audio` 。 | |Options |Container | 否 |\- |指定转码可选参数。|\ | | | | |父节点：`Transcode`。 | |AIGCMetadata |Container |否 |\- |视频 AIGC 元信息，见下面 `AIGCMetaddata` 。|\ | | | | |父节点：`Options`。 | |Label |String |是 |1 |生成合成标签要素，该标签用于标识目标视频属于、可能、疑似为人工智能生成合成的属性信息。|\ | | | | |父节点：`AIGCMetadata`。 | |ContentProducer |String |是 |tes_producer |生成合成服务提供者要素，内容为视频生成合成服务提供者的名称或编码。|\ | | | | |父节点：`AIGCMetadata`。 | |ProduceID |String |是 |123456 |内容制作编号要素，内容为视频生成合成服务提供者对该内容的唯一编号。|\ | | | | |父节点：`AIGCMetadata`。 | |ContentPropagator |String |否 |test_propagator |内容传播服务提供者要素，内容为视频传播服务提供者的名称或编码。|\ | | | | |父节点：`AIGCMetadata`。 | |PropagateID |String |否 |123456 |内容传播编号要素，内容为视频传播服务提供者对该视频的唯一编号。|\ | | | | |父节点：`AIGCMetadata`。 | |ReservedCode1 |String |否 |ewogICAgIm\*\*\*\*UiLAp9 |预留字段1，内容为用户自主开展安全防护，保护内容、标识完整性的信息。需经过 base64 编码后传入。|\ | | | | |父节点：`AIGCMetadata`。 | |ReservedCode2 |String |否 |ewogICAg\*\*\*\*\*UyIiwKfQ |预留字段2，内容为用户自主开展安全防护，保护内容、标识完整性的信息。需经过 base64 编码后传入。|\ | | | | |父节点：`AIGCMetadata`。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素 |参数名称 |参数类型 |示例值 |说明 | |---|---|---|---| |template_id |String |393161343761366633396119012ee2450b08 |创建音频转码模板的唯一 ID。 | ## **请求示例** ```JSON PUT /?process_template&tag=Transcode HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Content-Type: application/json Content-Length: Authorization: authorization string { "Tag": "Transcode", // 固定标识 "Name": "my-template", "TranscodeConfig": { "TimeInterval": { "Start": 0, "Duration": 10000, }, "Container": { "Format": "mp4" }, "Video": { "Codec": "h264", "Width": 480, "Height": 480, "Crf": 1, "PixFmt": "yuv420p" "BitRate": 3000000, "Fps": 24, "Remove": false }, "Audio": { "Codec": "aac", "BitRate": 128000, "SampleFormat": "fltp", "Channels": 2, "Remove": false }, "Options": { "AIGCMetadata": { "Label": "1", "ContentProducer": "test_producer", "ProduceID": "12345", "ContentPropagator": "test_propagator", "PropagateID": "12345", "ReservedCode1": "ewogICAgIm****UiLAp9", "ReservedCode2": "ewogICAg*****UyIiwKfQ" } } } } ``` ## **响应示例** ```JSON HTTP/1.1 200 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Content-Type: text/plain Content-Length: Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 393161343761366633396119012ee2450b08 ```

对象存储