Miku 快直播

    • Miku 快直播 > API 文档 > 直播转码API >新增实时流转码模板

    新增实时流转码模板

    最近更新时间: 2026-01-15 15:13:53

    描述

    创建一个新的实时流转码模板

    接口信息

    • 请求方法: POST
    • 请求地址: `mls.cn-east-1.qiniumiku.com
    • 请求路径: /

    请求参数

    Query 参数

    参数名称 类型 必填 示例值 描述
    codecTemplate string 必须 无 固定字段

    Header 参数

    参数名 类型 必填 示例值 描述
    Host string 是 mls.cn-east-1.qiniumiku.com 请求的服务域名
    Authorization string 是 <QiniuToken> 管理凭证 QiniuToken，生成规则

    Body 参数 (application/json)

    参数名称 类型 必填 描述
    name string 是 转码模版名称，支持大小写英文、数字、中划线，4到32个字符。请勿使用下划线。
    desc string 可选 转码模版描述，支持中英文、中划线和下划线，不超过100字符
    profile object 是 转码参数，对象字段可见 profile

    profile

    字段 类型 必填 取值范围 描述
    vcodec string 是 libx264、libx265 视频编码
    videoLongSide integer 否 - 视频长边，单位 px。 当长短边都指定时，转码流会按原视频长短边，强制缩放至目标分辨率；当只有长边指定时，会以长边为基准，按原视频比例自适应；当两边都不指定时，不修改原视频分辨率。 若指定视频长边大于原视频长边，则使用原视频长边进行转码。 长短边配合使用，与宽高不同时生效，长短边和宽高同时设置时，优先使用长短边设置 设置的边长需要为偶数，长边不大于3840px
    videoShortSide integer 否 - 视频短边，单位 px。 当长短边都指定时，转码流会按原视频长短边，强制缩放至目标分辨率；当只有短边指定时，会以短边为基准，按原视频比例自适应；当两边都不指定时，不修改原视频分辨率。 若指定视频长边大于原视频长边，则使用原视频长边进行转码。 长短边配合使用，与宽高不同时生效，长短边和宽高同时设置时，优先使用长短边设置 设置的边长需要为偶数，短边不大于2160px
    videoWidth integer 否 - 视频宽度，单位 px。 当宽高都指定时，转码流会强制缩放至目标分辨率；当只有宽度指定时，以宽度基准，按原视频比例自适应；当两边都不指定时，不修改原视频分辨率。 若指定视频宽度大于原视频宽度，则使用原视频高进行转码。 长短边配合使用，与宽高不同时生效，长短边和宽高同时设置时，优先使用长短边设置
    videoHigh integer 否 - 视频高度，单位 px。 当宽高都指定时，转码流会强制缩放至目标分辨率；当只有高度指定时，以高度基准，按原视频比例自适应；当两边都不指定时，不修改原视频分辨率。 若指定视频高度大于原视频高度，则使用原视频高进行转码。 长短边配合使用，与宽高不同时生效，长短边和宽高同时设置时，优先使用长短边设置
    videoBitRate integer 否 - 视频码率，单位 kbit/s。为空时表示不强制设置码率。在不改变视频编码格式时，若指定码率大于原视频码率，则使用原视频码率进行转码。
    vbNotExceedInput boolean 否 - 是否限制视频输出码率不超过视频输入码率
    videoFrameRate integer 否 - 视频帧率，单位 fps。为空时表示不改变原视频帧率
    keyframeInterval integer 否 - 关键帧间隔，单位：秒。 为空时系统会默认将 关键帧间隔设置为 2
    removeBFrame boolean 否 - 是否去除B帧，为空时表示不去除B帧
    keepSei boolean 否 - 是否保留原视频中的SEI信息，为空时表示不保留SEI信息
    audioVideoType integer 否 - 音视频输类型， 为空或0时表示同时输出音视频；1表示只输出视频；2表示只输出音频。
    acodec string 否 - 音频编码，为空时表示不改变原音频编码
    ac integer 否 - 声道数，为空时表示不改变原视频声道数
    ab integer 否 - 音频码率，单位 kbit/s。为空时表示不强制设置码率。在不改变音频编码格式时，若指定码率大于原音频码率，则使用原音频码率进行转码
    ar integer 否 - 音频采样率，单位 Hz。为空时表示不改变原视频的音频采样率

    请求示例

    POST /?codecTemplate HTTP/1.1
Host: mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>
Content-Type: application/json

{
  "name": "my480p",
  "desc": "480p实现",
  "smart": false,
  "profile": {
    "videoWidth": 640,
    "videoHigh": 480,
    "ab": 128,
    "ar": 44100,
    "vcodec": "libx264"
  }
}

    返回响应

    响应状态码

    响应示例

    {
  "connectId":"CJoCCDR8Zq2ptYgY",
  "desc":"480p实现",
  "name":"my480p1",
  "preview":{
    "ab":"128k",
    "acodec":"aac",
    "ar":"44100",
    "force_key_frames":"expr:gte(t,n_forced*2)",
    "vcodec":"libx264",
    "vf":"scale='if(gt(640,iw), iw\\, 640)':'if(gt(480,ih)\\, ih\\, 480)'"
  },
  "profile":{
    "vcodec":"libx264",
    "videoWidth":640,
    "videoHigh":480,
    "keyframeInterval":2,
    "ab":128,
    "ar":44100
  }
}

    响应参数

    参数名称 类型 说明 是否必需
    connectId string 当前请求 connectId 必需
    desc string 转码模板描述 必需
    name string 转码模板名称 必需
    preview object 转码模版对应ffmpeg转码参数 可选
    profile object 新增转码模板时传入的转码参数 必需
    以上内容是否对您有帮助？