创建视频智能修复任务
您可以使用本接口创建视频修复任务,自动检测并修复视频问题。
请求
地址 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);
相关链接 * 智能修复