# 创建或更新转码模板 (/zh-CN/api-reference/api-ref/cloud-transcoding/template-create) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 创建或更新指定 App ID 下的转码模板。 - OpenAPI: /openapi/cloud-transcoding/cloud-transcoding.zh-CN.yaml - Operation ID: post-v1-projects-appId-rtls-abr-config-codecs-codecId - Method: POST - Path: /v1/projects/{appId}/rtls/abr/config/codecs/{codecId} - Endpoint: https://api.sd-rtn.com/v1/projects/{appId}/rtls/abr/config/codecs/{codecId} ## Servers - https://api.sd-rtn.com 创建或更新指定 App ID 下的转码模板。 - 发起请求创建转码模板时,Body 中所有字段都是必填。 - 创建后,如果你想更新转码模板,可以再次发起请求。更新视频属性时,你需要填写完整的 `video` object,不能只填写 `video` object 中的单个字段。 ## Authorization This endpoint requires authentication. - `Basic Auth` - `API Key` ## Parameters - `Content-Type` (header, required, string) - `application/json` - `codecId` (path, required, string) - 转码模板的 ID。字符串长度不超过 64 字节,支持的字符集范围(共 89 个字符)如下: - 26 个小写英文字母 a~z - 26 个大写英文字母 A~Z - 10 个数字 0~9 - 空格 - `!`、`#`、`$`、`%`、`&`、`(`、`)`、`+`、`-`、`:`、`;`、`<`、`=`、`.`、`>`、`?`、`@`、`[`、`]`、`^`、`_`、`{`、`}`、`|`、`~`、`,` **用法说明**:假设你在频道名为 `channel` 的频道中开启观众端多码率功能,并且创建转码模板,设置转码模板 ID 为 `codecId`。那么,观众端进入对应的 `channel_codecId` 频道即可订阅经过转码模板处理过的多码率主播流。 - `appId` (path, required, string) - 声网为每个开发者提供的 **App ID**。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。 ## Request body - `enabled` (boolean, required) - 是否开启该转码模版: - `true`:开启该模板。 - `false`:不开启该模板。 - `video` (object, required) - `video.width` (number, required) - 转码输出视频的宽度 (px)。 - Range: `(0, 1920]` - `video.height` (number, required) - 转码输出视频的高度 (px)。 - Range: `(0, 1920]` - `video.fps` (number, required) - 转码输出视频的帧率 (fps)。 - Range: `(0, 60]` ## Responses ### 200 如果状态码为 200,则请求成功。 - `status` (string) - 本次请求的状态: - `success`:请求成功。 - `error`:请求失败。 ### 非 200 如果状态码不为 200,表示请求失败。请根据响应状态码和 `message` 字段进行排查。 - `status` (string) - 本次请求的状态: - `success`:请求成功。 - `error`:请求失败。 - `message` (string) - 描述请求失败的原因。 ## Response examples ### 200 ```json { "status": "本次请求的状态:\n- `success`:请求成功。\n- `error`:请求失败。\n" } ``` ### 非 200 ```json { "status": "本次请求的状态:\n- `success`:请求成功。\n- `error`:请求失败。\n", "message": "描述请求失败的原因。" } ```