← 返回目录
📁 Marketing API › Catalog Management › Guides › (Deprecated) Create catalog videos using custom templates

(已废弃)创建视频包

视频包是一组可以直接用于广告(如购物广告)创作的视频。现在您可以使用TikTok API for Business创建绿幕视频包。

所需素材

您需要以下素材来创建一个绿幕视频包:

  • 一个绿幕视频
  • 几个常规视频
  • 视频模版
  • 音乐文档

在通过API创建绿幕视频包时,您需要这些素材的ID (video_id, template_id以及 music_id)。请您提前将视频、音乐以及模板上传至创意库或商务中心账号。

素材要求

  • 有且只能有一个绿幕视频。
  • 绿幕视频时长不能超过20秒。
  • 绿幕视频时长不能小于模板视频时长。
  • 音乐时长不能小于总视频时长。
  • 绿幕视频的绿幕部分的RGB通道值要满足以下条件:R和B通道值小于120,G通道值大于150。同时要确保HSV的H通道值大于70,小于154。例如,RGB为(50,217,70)。
  • 视频模板分辨率不超过720x1280,分辨率过大可能导致渲染失败。

创建视频包

向/catalog/video_package/create/接口发起POST请求,创建视频包。接口设置如下: * video_package_type 设为 GREEN_SCREEN。目前仅支持该视频包类型。 * 传入模版ID(template_id)和音乐ID(music_id)。 * 将视频数据按顺序排列后传入。每个视频是一个对象。视频数据的排列顺序决定最后视频的顺序。 * 对于唯一的绿幕视频,将is_green_screen_video 参数设置为true。对于常规视频,将此字段设置为false。

在视频包创建成功后,您可以对其进行重命名,预览和删除。

API参考

以下是一个创建视频包的请求中的数据示例。

(code JSON JSON)
{
    "bc_id": 6725320885500118022,
    "catalog_id": 6986901069595002626,
    "video_package_type": "GREEN_SCREEN",
    "videos": [
        {"video_id": "v07033g50000c38pjfoupb082t6ln5f0", "is_green_screen_video": false},
        {"video_id": "v10033g50000c4574b3c77uaa2tq5100", "is_green_screen_video": true},
        {"video_id": "v07033g50000c23ptb2h6o7cqvaadut0", "is_green_screen_video": false}  
    ],
    "template_id": "6992826957676134402",
    "name": "green screen generation",
    "music_id": "6904951200983285762"
}
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →