← 返回目录
📁 API Reference › Creative Tools

(已废弃)创建一键优化任务

您可以使用本接口简单快速的创建一个视频优化任务。当前主要功能功能为将横向视频更改为竖向视频。任务的执行时间大概是视频时长的 1/2。

请在智能配乐、微电影、一键优化中查看本功能的简要介绍。

生成视频名称 <orign_video_name>_optimize_<index>.mp4。

该接口频控限制:

| 等级{20%} | 秒级调用限制(QPS){20%} | 分钟级调用限制(QPM){20%} | 天级调用限制(QPD){20%} |
| 初级 | 1 | 30 | 5000 |
| 标准级 | 2 | 60 | 10000 |
| 高级 | 3 | 90 | 15000 |

v1.2与v1.3版本对比

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



## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/creative/quick_optimization/create/

**方法** POST

**Header**

```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|

参数

|字段|类型|描述|
|-|-|-|
| advertiser_id{必填} |  string | 广告主ID。 |
| video_id{必填}      | string   | 视频ID。 |
| logo | string | 品牌标识图片ID。将在优化视频中显示。 |
| title | string |标题。将在优化视频中显示。限制:2-20个字符。|
| description  | string |描述。将在优化视频中显示。 |
| 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)

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