← 返回目录
📁 API Reference › Creative Tools

创建视频智能修复任务

您可以使用本接口创建视频修复任务,自动检测并修复视频问题。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/video/fix/task/create/

方法 POST

Header

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|tasks|object[]|任务信息。最多为10条记录。|
#|video_id {必填}|string|希望修复的视频对应的ID。|
#|auto_bind_enabled|boolean|是否将修复后的视频自动上传至素材库。默认值:`False`。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/open_api/v1.3/video/fix/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "advertiser_id": "{{advertiser_id}}",
  "tasks": [
    {
      "video_id": "{{video_id}}"
    },
    {
      "video_id": "{{video_id}}"
    }
  ]
}'
(/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|返回数据。|
#|tasks |object[]|任务信息。最多为10条记录。|
##|video_id|string|希望修复的视频对应的ID。未检测到视频问题时返回。|
##|fix_task_id|string|修复任务ID。检测到视频问题时返回。|
##|flaw_types|string[]|监测到视频问题时返回。<br><br>视频问题类型。<br><br>枚举值:<ul><li>`LOW_RESOLUTION`:视频分辨率低于540x960 px, 不符合要求。</li><li>`ILLEGAL_VIDEO_SIZE`:视频尺寸的比例不符合竖版(9:16),方版(1:1),横版(16:9)的要求。</li><li>`NO_BGM`(<span style="color:Red">已废弃</span>):广告或视频没有背景音乐,或背景音乐不连贯/不清晰。</li><li>`BLACK_EDGE`(<span style="color:Red">已废弃</span>):视频画面中出现影响用户体验的黑边。</li><li>`ILLEGAL_DURATION`(<span style="color:Red">已废弃</span>):视频长度长于 60 秒或短于 5 秒,不符合要求。|
|request_id |string|请求的日志 ID,唯一标识一个请求。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "202208180945000102452480040607B21A",
    "data": {
        "tasks": [
            {
                "flaw_types": [
                    "NO_BGM",
                    "LOW_RESOLUTION"
                ],
                "video_id": "v09033f20000bojg7jbdjls6pfaa9i2g",
                "fix_task_id": "130782063140497479"
            },
            {
                "flaw_types": [
                    "ILLEGAL_DURATION",
                    "NO_BGM",
                    "BLACK_EDGE"
                ],
                "video_id": "v090332c0000bp1th2f7421ibbs4cp10",
                "fix_task_id": "130781343733475399"
            }
        ]
    }
}
(/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 每日平台更新简报 →