(已废弃)创建智能配乐任务
您可以使用本接口创建智能配乐任务。任务的执行时间大概是视频时长的 1/2。
请在智能配乐、微电影、一键优化中查看本功能的简要介绍。
该接口频控限制为:
xtable
| 等级 {20%} | 秒级调用限制(QPS){20%} | 分钟级调用限制(QPM){20%} | 天级调用限制(QPD){20%} |
| --- | --- | ---- | ---|
| 初级 | 1 | 30 | 5000 |
| 标准级 | 2 | 60 | 10000 |
| 高级 | 3 | 90 | 15000 |
版权声明
受音乐版权限制,使用我们提供的音乐制作的视频仅可在TikTok投放。 您不可下载视频或其中包含的音乐文件,不可在TikTok以外的任何媒介提供、传播、播放视频或其中包含的音乐文件,除非您已向音乐版权方另行获得许可。 因您违反上述规则而引发的投诉、纠纷,由您承担全部法律责任并应赔偿TikTok或TikTok关联公司因此遭受的损失。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/creative/video_soundtrack/create/|/v1.3/creative/video_soundtrack/create/|
|请求参数类型|advertiser_id: number |advertiser_id`: string |
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/creative/video_soundtrack/create/
**方法** POST
**Header**
```xtable
|字段|类型|描述|
|--- |--- |--- |
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} | string| 广告主 ID。 |
| video_id{必填} | string | 视频 ID。 |
| music_ids | list[string] | 自定义音乐 ID 列表。如果想要使用自选的音乐,那么使用这个字段进行设置。如果想要使用系统推荐的音乐,忽略该字段。数量限制:9 个以内。 |
| video_volume | float | 视频音量。取值范围:[0, 1]。数值越大,音量越大。默认 值:0.5。 |
| music_volume | float | 音乐音量。取值范围:[0, 1]。数值越大,音量越大。默认值:0.5。 |
| name_prefix | string | 视频名称前缀。长度限制在 [1, 90]。如果不传,使用原视频名称作为 `name_prefix`。生成视频名称:`<name_prefix>_<music_name>`。<br> 若音乐无名称,生成的视频名称为`<name_prefix>_<timestamp>`。 |
| callback_info | object | 回调信息。 |
#| callback_url{+必填} | string | 回调地址。当传入`callback_info`时,该字段必填。 |
#| callback_extra_info | object | 回调附带信息。 |
返回
|字段|类型|描述|
|-|-|-|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|task_id |string|任务ID。 |
|request_id|string|请求日志ID。|
示例
(code Success-Response python)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"task_id": 1864502164429996038
},
"request_id": "2020082410541601018904922344E10F07"
}
(/code)