• 开发者工具 IDE
  • 沙盒环境
  • 抖音云
  • 产品介绍
  • 快速开始
  • 场景指南
  • 操作指南
  • 账号入驻
  • 服务管理
  • 组件中心
  • 设置
  • 资源用量
  • 运维管理
  • 费用中心
  • 火山引擎
  • 行业解决方案
  • 短剧媒资管理
  • 媒资管理OpenApi
  • 短剧媒资管理常见问题
  • 大模型
  • 函数服务管理
  • 浏览器启用第三方 cookie配置指引
  • 总览
  • 操作限制
  • 开发指南
  • SDK参考
  • 产品动态
  • 产品计费
  • 常见问题
  • OpenAPI调试台
  • 一、介绍

    抖音云为短剧小程序推出的视频托管方案,提供抖音短视频级别的视频播放体验。
    短剧媒资管理与抖音小程序侧短剧内容库深度打通,降低接入成本
      1.存储在抖音云的视频可直接提审,无需重复上传
      2.通过抖音开放平台接口提审短剧自动同步上传到抖音云
      3.剧集在抖音小程序侧的审核状态、可播放状态同步显示。
    视频播放方面,支持抖音小程序端播控组件,传入剧目 ID、剧集 ID 在权限校验通过后播放抖音云上的视频。同时,可调用 OpenApi 生成播放链接用于抖音小程序端外的播放。
    抖音小程序短剧内容库接入文档请前往抖音开放平台控制台的 「能力-解决方案-垂直行业-短剧行业」查看。
    短剧新手大礼包活动:原价 1472 元活动价 180 元,包含 5TB 流量,500GB 存储,5000 分钟标准转码。

    二、使用限制

      1.定向向短剧小程序行业开放,请提交 工单 申请,通过后可进行接入。
      2.仅限抖音云 prod 环境开通使用

    三、操作指引

    开通

    通过申请的小程序,可以看到「行业解决方案-短剧」下的「媒资管理」能力
    点击开通后,弹出「开通媒资管理」弹窗,点击确认后,完成开通。
    点击管理,进入「媒资管理」详情页

    设置域名

    添加域名

    绑定域名后才能进行播放,请先完成域名绑定。点击「新增域名」,域名需先完成备案且未被绑定。
    添加域名后,预期 1 分钟配置状态会从「配置中」流转到「配置完成」,请刷新页面。
    配置证书:配置完成后,可进行证书配置,请传入与域名对应的证书。
    配置CNAME 解析:启用后请前往域名托管商处,添加 CNAME 域名解析到域名管理处提供的 CNAME 域名。
    启用域名:CNAME 配置完成后,再启用域名。域名启用后,在未设置默认域名的清空下,会使用已启用的域名进行随机分发,请确保域名 CNAME 解析正常,否则将导致无法播放。

    设置默认域名&域名流量分析

    设置默认域名:未设置默认域名时会在「域名运行正常」的域名列表中随机分发。
    注意:CNAME 解析如异常,将无法播放。设置默认域名后,则 video-play 组件及 OpenApi 会使用默认域名。
    域名流量分析:支持对域名维度进行流量分析,点击「域名流量分析」

    视频转码

    视频转码能显著降低视频大小,提升用户播放体验,同时可降低开发者的流量成本。

    播放策略

    视频播放策略根据端的不同分为如下两种场景
      1.抖音小程序端播放策略:未转码时则播放原片,有转码则播放转码后视频,如果用户客户端支持 H.265 将优先播放「极智超清 MP4 720P H.265」,不支持则按照「极智超清 MP4 720P H.264」>「标准转码 HLS 720P H.264」顺序播放
    在抖音小程序内 MP4 格式的播放时延、失败率都更低,推荐 MP4 播放。
      2.业务在抖音小程序端外,可通过抖音云媒资管理openApi中「根据 Vid 获取可播放链接」接口拉取到所有格式视频后,根据自身场景需要进行选档播放。

    转码配置

    抖音云提供如下 3 个转码配置,两个转码配置对应着不同的计费项及资源包,推荐购买资源包更加优惠。
    注:有自定义转码诉求可直接上传转码后视频。
    转码配置
    说明
    计费项
    按量付费的单价
    费用预估
    极智超清 MP4 720P H.264(推荐)
    在同等画质下高清低码会比普通转码码率更低;节省流量成本且提升用户播放体验
    视频转码时长-极智超清
    0.0981 元/分钟
    每部短剧 200 分钟,100 部短剧时转码费用为 0.0981*200*100=1962 元。
    极智超清 MP4 720P H.265(推荐)
    同等画质下 H.265 视频大小可 H.264 降低约 20%~30%。
    视频转码时长-极智超清
    0.489 元/分钟
    每部短剧 200 分钟,100 部短剧时转码费用为 0.489*200*100=9780 元。
    普通转码 HLS 720P H.264
    抖音小程序端将优先播放 MP4 格式视频,没有 MP4 格式时再播放 HLS 格式。
    MP4 首帧播放时延、失败率更低。因此,如果仅在抖小侧播放转码 MP4 即可。
    视频转码时长-标准转码
    0.0326 元/分钟
    每部短剧 200 分钟,100 部短剧时转码费用为 0.0326*200*100=652 元。

    转码操作

    操作类型
    说明
    视频上传后转码
    点击「转码设置」,开启「视频上传后转码」后上传的视频会自动进行转码。
    手动触发转码任务
    在「视频管理」页面可手动勾选视频列表,触发转码任务。
    高热视频转码
    通过仅对高热视频进行转码,可降低转码成本。
    OpenAPI 转码

    转码接入流程

    极智超清转码和 H.265:实现抖音同款清晰度,显著节省带宽成本并优化用户体验,提升用户时长。
      1.极智超清转码:基于主观视觉优化的智能编解码算法,同等等主观画质的前提下实现码率和带宽的极致压缩。
      2.H.265:一种较 H.264 更高效的编码方式,支持自动回退保障播放兼容性,设备不支持 H.265 协议时自动降级到 H.264 资源,保障播放兼容性;
    接入成本:无需开发,控制台验证后一键操作接入。
    接入收益:
      1.有效节省带宽成本:「极智超清 H.265」文件大小可减少 20-40%。
      2.显著优化用户体验,提升用户时长:业务 A/B 实验数据,播放失败率-28%,卡顿率下降30%。

    转码效果示意

      1.片源画质更好,能够有更好的压缩率、转码后的画质也更好。建议上传高清晰度的原片进行转码,以提升画质体验。
      2.以下仅用于压缩比例示意,线上生产时还需要业务验证画质是否符合预期。
      3.从示例看原片如果已经足够小,二次转码后文件可能会变大。
    转码效果
    转码前视频大小(单位:MB)
    206.48
    103.78
    48.67
    30.21
    20.71
    10.30
    普通转码 HLS 720P H.264
    (单位:MB)
    33.43
    17.30
    11.42
    7.00
    16.08
    18.15
    极智超清 MP4 720P H.264
    (单位:MB)
    31.47
    14.60
    8.96
    5.78
    13.19
    13.92
    极智超清 MP4 720P H.265
    (单位:MB)
    20.48
    码率823.54Kbps
    10.79
    码率947.24Kbps
    6.98
    码率521.61Kbps
    3.77
    码率 467.14Kbps
    8.78
    码率 517.58Kbps
    10.24
    码率 668.93Kbps

    手动转码验证效果

    抖音云控制台上传视频
    手动转码
    验证转码效果
    数据回收
      1.上传视频为原片:直接上传原片视频即可
      2.上传视频为已转码的视频:建议同时上传原片和已转码的视频
    建议同时勾选推荐的 2 个模板,避免客户端不支持 H.265 时降级到原片导致播放流量上升。
      1.在转码完成后,点击「视频地址」,在侧拉弹窗中看转码后的视频大小
      2.点击「预览」查看视频画质是否符合预期
    前往「视频播放统计」对比转码前后视频的流量消耗情况。

    验证效果后接入转码

    验证结果
    接入操作
    原片
    转码后视频
    增量
    存量
    符合预期
    上传的是原片
    在「转码设置」中启用「视频上传后转码」,同时勾选 2 个推荐的模板,后续上传视频会自动进行转码
    开启「高热视频转码」,系统将对超过播放次数阈值的存量视频自动进行转码。
    上传的已转码视频
    符合预期
    在「转码设置」中启用「视频上传后转码」,同时勾选 2 个推荐的模板,后续上传视频会自动进行转码
    长期建议: 对比验证原片转码和二次转码的效果,评估后续是否直接上传原片到抖音云,此时涉及开发
    上传的已转码视频
    不符合预期
    增量视频改造为直接上传原片后,在「转码设置」中启用「视频上传后转码」,后续上传视频会自动进行转码
    暂不操作,避免对线上产生影响
    不符合预期
    -
    可在抖音云的工单/飞书对接群等渠道中向我们反馈

    转码资源包购买

    「极智超清」和「普通转码」是 2 个不同的计费项,对应着不同的资源包。
    在资源包耗尽后将会按量付费扣除账户余额,单价会更高。

    视频播放统计

      1.播放次数/流量Top100 视频:支持分析最近 30 天,当日11:00可查询前一天的统计数据。
      2.视频播放情况查询:支持全局、小程序维度分析视频播放流量。基于CDN播放日志中的 referer 字段中的 appid 信息进行统计,部分机型 referer 为空将不会被统计到小程序维度下。

    查看用量及购买资源包

      1.查看用量曲线,支持按照日期筛选。配置完监控后 1 天,监控曲线方能展示。
      2.点击购买资源包,可购买 视频分发流量、媒资管理用量、视频转码时长-标准转码、视频转码时长-极智超清 四类资源包。
      3.点击「查看资源包」跳转到「资源实例管理」,点击「资源包」tab 查看「视频点播」的资源包。

    视频管理、上传、播放

      1.「视频管理」支持按照视频名、送审状态、转码状态、视频来源进行过滤。
      a.检索能力:支持按照名称模糊搜索,通过 vid 精准搜索。
      b.列表字段
      i.视频名:可重复,不唯一
      ii.VID: 视频唯一 ID
      iii.内容库视频 ID:视频同步到抖音开放平台内容库后的视频 ID,需要通过该视频 ID 在内容库中进行送审。
      iv.是否送审:枚举值,包括已送审、未送审。抖音云仅标记该视频是否已送审,完整的审核结果请调用抖音小程序内容库接口进行查询。
      v.转码状态:枚举值,未转码、转码中、已转码、转码失败
      vi.视频来源:短剧内容库同步、控制台上传、接口上传
      2.点击「视频上传」,m3u8 格式上传请走抖音云提供的媒资管理 OpenApi。
      3.点击操作「视频地址」,将侧拉展示视频列表。如果视频无法预览,自查如下问题
      a.域名 CNAME 是否配置正常。
      b.m3u8 播放需要安装 chrome 扩展 HLS Player - m3u8 Streaming Player

    播放指引

      1.在抖音小程序侧可通过剧集 ID、剧目 ID 直接播放托管在抖音云上的视频,详情见短剧内容库的文档。
      2.在抖音小程序外可通过 OpenApi 的方式生成播放链接进行播放,小程序外的播放不受短剧内容库的审核状态影响。

    协作者权限管理

    在团队协作过程中,希望协作者权限最小化,可通过抖音云用户权限进行权限分配。
    2024年7月18 号 抖音云用户权限升级支持编辑协作者权限,为保证权限最小化,对协作者操作「媒资管理」权限进行了回收,如需权限请联系管理员授权。
    协作者访问无权限
    管理员前往「用户权限」修改
    添加「媒资管理」权限

    计费相关

    计费说明

    媒资管理开通后会为你创建「视频点播」资源,计费由「视频点播」收取,详情以计费概述--视频点播为准。
    目前支持按量计费和资源包 2 种模式
      1.按量计费会根据用量计算费用并从账户余额中扣除
      2.资源包,每个计费项对应一类资源包,有资源包则优先从资源包中抵扣。
    抖音云按量计费说明示例
    计费项
    说明
    按量付费单价
    计费示例
    视频流量分发
    适用于视频分发流量抵扣,按流量计费。
    0-10TB(含) 0.22 元/GB
    10TB-50TB(含) 0.21 元/GB
    50TB-100 TB(含)(含)0.18 元/GB
    100TB-1PB(含) 0.16 元/GB
    大于 1PB 0.15 元/GB
    假设用户 A 于 2023 年 8 月流量分发 170TB,则
    (10*0.22+40*0.21+50*0.18+70*0.16)*1000=30800 元
    进制:流量的进制为 1,000。进制换算规则为: 1 PB = 1,000 TB = 1,000 × 1,000 GB, 1 PB = 1,000 × 1,000 × 1,000 MB。
    媒资管理用量
    适用于媒资管理存储用量抵扣。
    0.099 元/GB/月
    假设用户 A 于 2023 年 8 月存储了 300 GB 的视频。当月用户 A 产生的费用如下:
    存储费用 = 300 (GB) x 0.099 (元/GB/月) = 29.7 (元)
    视频转码时长-极智超清
    对应抖音云转码配置「极智超清 MP4 720P H.264」
    0.0981 元/分钟
    每部短剧 200 分钟,100 部短剧时转码费用为 0.0981*200*100=1962 元。
    视频转码时长-标准转码
    对应抖音云转码配置「普通转码 HLS 720P H.264」
    0.0326 元/分钟
    每部短剧 200 分钟,100 部短剧时转码费用为 0.0326*200*100=652 元。

    账户充值及设置余额预警

    账号余额不足时请及时充值,避免账号欠费导致停服。
      1.点击右上角「费用中心」,进入「充值」界面,支持在线支付、线下汇款。
      2.点击右上角「费用中心」,开启「可用余额预警」并设置余额提醒阈值
      3.点击「用户权限」,添加管理员。余额预警将会发送给管理员。

    计费配置变更

    计费配置默认为「按日结算-视频分发服务按流量」,如需「按月结算」等配置请联系抖音云对接商务为你开通。

    资源包抵扣规则

    注意事项
      每日用户消耗的各项点播资源,将优先在相应的资源包内抵扣,超出相应的资源包部分使用 按量付费 方式计费。
      资源包支持叠加购买,即有效期内资源用量叠加,多个资源包按购买时间先后进行抵扣。
      资源包购买当日生效。当日购买的资源包,无法抵扣当日结算的(即前一日产生的)费用。
      用户购买资源包 7 天内,若未使用,可申请全额退款;若已使用或超出 7 天,则不支持退款。
    资源包类型
    抵扣说明
    媒资管理资源包
    可抵扣媒资管理的费用,取每日媒资容量峰值为当天的计费值。
    视频分发流量
    可抵扣流量的用量,按播放区域所在节点产生的流量(GB)计费。流量的进制为 1,000。进制换算规则为: 1 PB = 1,000 TB,1 TB = 1,000 GB,1 GB = 1,000 MB。
    音视频转码时长
    可抵扣标准转码、极智超清的时长。此时长指转出 H264 + 480P(640 * 480) 分辨率的转码时长,其它编码格式、分辨率组合需要按比例进行抵扣
    抖音云转码配置的抵扣比例
    转码配置
    资源包抵扣比例
    极智超清 MP4 720P H.264(推荐)
    1:4.52
    极智超清 MP4 720P H.265(强烈推荐)
    1:22.53
    普通转码 HLS 720P H.264
    1:1.5

    查看账单

    点击顶部导航栏的「费用中心」,进入「账单详情-账单明细」查看。
      1.产品:媒资管理对应的产品为「视频点播」
      2.计费模式:包年包月(资源包)、按量付费
      3.计费单元:资源包的话就是资源包名称,按量付费的话就是计费项名称。
      4.单价价格类型:视频分发流量为阶梯定价
      5.资源包抵扣量:按量付费的计费项,如果有资源包会优先走资源包抵扣

    OpenApi 接入

    抖音云支持 OpenApi 的方式进行接入,提供如下接口。
      1.分页获取媒资列表
      2.删除媒资列表
      3.根据 Vid 获取可播放链接
      4.通过 Url 批量上传视频
      5.查询 URL 批量上传任务状态
      6.媒资转码
      7.查询转码的状态

    常见问题

    托管在抖音云的视频支持在 App 等端播放吗?

    支持,可通过 OpenApi 生成可播放链接用于在抖音小程序外播放。

    欠费充值后仍然无法播放?

    欠费后域名将停用,需要手动在控制台进行启用域名。