← 返回目录
📁 API Reference › (Deprecated) Dynamic Scene

(已废弃)提交素材

您可以使用本接口为动态场景提交素材。

提交素材后,您需使用/dynamic_scene/task/create/创建一个异步任务。

注意
动态场景API目前处于测试阶段。若要申请使用该接口,请通过白名单功能管理。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/dynamic_scene/material/submit/| /v1.3/dynamic_scene/material/submit/| |请求参数类型|advertiser_id: number |advertiser_id`: string |



## 请求

**地址**
https://business-api.tiktok.com/open_api/v1.3/dynamic_scene/material/submit/


**方法** POST

**Header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
#|slots {必填}|[]object|槽位,最大数量为6。|
##|order {必填}|number|槽位在故事线的顺序,范围:0-5。|
##|tag {必填}|string|槽位的标签。|
##|video_ids {必填}|[]string|视频素材。您可以通过[上传视频](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)接口获取视频ID。但在该字段中填入的ID不得多于10个。 |
##|mute|boolean|是否关闭分镜的原声。默认值: `false`。如果您将其设为 `true`, 那么 `bgm_volume` 为 `100`。<br> 注意: 无背景乐情况下(没有`music_ids`以及不开启`auto_soundtrack`)不允许将`mute`设为`true`。|
##|bgm_volume|number| 背景乐音量,范围是[0, 100]。|
|auto_soundtrack|boolean|是否自动创建背景乐。默认值:`false`。|
|music_ids|[]string|音乐素材。您可以通过[上传音乐](https://ads.tiktok.com/marketing_api/docs?id=1740052650395650)接口获取音乐ID。|

示例

(code curl http)
{
    "slots": [{
        "order": 0,
        "tag": "asd",
        "video_ids": ["32wdsd3232784yjfvh343dsf"],
        "mute": false,
        "bgm_volume: 30
    }],
    "auto_soundtrack": false,
    "advertiser_id": 75960823018
}
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。|
#|material_package_id|string|素材包ID。|
|request_id |string|请求的日志id,唯一标识一个请求。 |

内容来源: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 每日平台更新简报 →