← 返回目录
📁 API Reference › Creative Tools

获取视频智能修复结果

您可以使用本接口获取视频修复任务的结果。

请求

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

方法 GET

Header

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

参数

|字段|类型|描述|
|---|---|---|
|task_id {必填}|string|修复任务ID。请传入从[/video/fix/task/create/](https://ads.tiktok.com/marketing_api/docs?id=1741468875279361)或[/file/video/ad/upload/](https://ads.tiktok.com/marketing_api/docs?id=1737587322856449)接口返回的`fix_task_id`。|
|advertiser_id {必填} | string |广告主ID。 <br>注意:如果`task_id`和`advertiser_id`不匹配,会返回报错信息。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/video/fix/task/get/?advertiser_id={{advertiser_id}}&task_id={{task_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/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|返回数据。|
#|status|string|任务状态。枚举值:`PROCESSING`, `FAILED`, `SUCCESS`。|
#|error_msg|string|报错信息。仅当`status`为`FAILED`时返回。|
#|videos|object[]|已修复视频信息。最多为3条记录。仅当`status`为`SUCCESS`时返回。 |
##|video_id|string|已修复视频ID。|
##|video_url|string|已修复视频的预览URL。有效期为7天。|
|request_id |string|请求的日志ID,唯一标识一个请求。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "202208180952320101860032142108B920",
    "data": {
        "error_msg": null,
        "videos": [
            {
                "video_url": "http://v16m-default.akamaized.net/a17b15b1c623eea1856c89d521af1bfc/63074676/video/tos/alisg/tos-alisg-v-0000/c98a4fb0433d4e3e9adf27228c7543cb/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=748&bt=374&cs=0&ds=1&ft=uSV.Ng3-Inz.Jx9oABM&mime_type=video_mp4&qs=0&rc=NTk2NWk7Nzg0O2VlMzloZUBpamtvcmU6ZnIzZTMzODYzNEAuMV9gLTIwNmAxLWMyNGI1YSNxLjNicjRnanNgLS1kMC1zcw%3D%3D&l=202208180952320101860032142108B920&btag=80000",
                "video_id": "v10033g50000cbv0mojc77ubeo6l1htg"
            },
            {
                "video_url": "http://v16m-default.akamaized.net/85d8eb552878e7f12f81c692e987bdb8/63074676/video/tos/alisg/tos-alisg-v-0000/67029d0cd5a7411bbd25c42062765a21/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=748&bt=374&cs=0&ds=1&ft=uSV.Ng3-Inz.Jx9oABM&mime_type=video_mp4&qs=0&rc=M2k4OTs3Zjg6aWU0aTU7O0BpM3BqeWY6ZnIzZTMzODYzNEA1Yl81NS8vXjExNWJfYTY1YSNnZmAucjRnanNgLS1kMC1zcw%3D%3D&l=202208180952320101860032142108B920&btag=80000",
                "video_id": "v10033g50000cbv0mojc77uc1vcgimj0"
            },
            {
                "video_url": "http://v16m-default.akamaized.net/11609ae2c7055dfee98b657103e4e3e0/63074676/video/tos/alisg/tos-alisg-v-0000/cd9e274c0def4d398b1228a35ebabd19/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=746&bt=373&cs=0&ds=1&ft=uSV.Ng3-Inz.Jx9oABM&mime_type=video_mp4&qs=0&rc=NjNkNzo8NGhoNmlmaTxpNkBpM2U4bzk6ZnMzZTMzODYzNEBeMDJeXzY2NmExNDMxMV4yYSNwNWhhcjQwanNgLS1kMC1zcw%3D%3D&l=202208180952320101860032142108B920&btag=80000",
                "video_id": "v10033g50000cbv0mp3c77u6dlk58bs0"
            }
        ],
        "status": "SUCCESS"
    }
}
(/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 每日平台更新简报 →