（已废弃）获取异步任务结果

您可以使用本接口获取异步任务结果。

若任务已完成（status = SUCCESS），您可以调用/dynamic_scene/get/下载基于您提交的素材包所生成的视频。

注意
动态场景API目前处于测试阶段。若要申请使用该接口，请通过白名单功能管理。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/dynamic_scene/task/get/| /v1.3/dynamic_scene/task/get/| |请求参数类型|advertiser_id: number |advertiser_id: string | |返回参数名称|url|video_preview_url` |



## 请求

**地址**

https://business-api.tiktok.com/open_api/v1.3/dynamic_scene/task/get/

**方法**  GET

**Header**

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|task_id|string|[创建任务](https://ads.tiktok.com/marketing_api/docs?id=1740317320231938)接口返回的任务ID。|

|字段|类型|描述|
|---|---|---|
|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`, `FAIL`, `SUCCESS`。|
#|error_msg|string|若任务异常，产生的错误信息。|
#|material_package_id|string|该任务相关的素材包ID。 |
#|available_quota|number|可用的视频份额。您可以另建一个任务创建更多视频，但视频数量不得超过份额。|
#|videos|object[]|动态分镜接口创建的视频，最大数量为8。|
##|music_id|string|音乐ID。|
##|music_name|string|音乐名称。|
##|music_preview_url |string|音乐预览链接。 |
##|width|number| 视频宽度。|
##|height|number| 视频长度。|
##|duration|number|视频时长（秒）。|
##|story_arc|string[]|故事线。故事线中可包括多个槽位。|
##|video_id|string|生成的视频ID。视频可用于创建广告。|
##|video_preview_url|string|视频预览链接。 |
##|slots |object[]|槽位信息。|
###|order |number|槽位在故事线的顺序，范围：0-5。|
###|tag |string|槽位的标签。|
###|video_ids|string[]|视频素材ID。|
###|mute|boolean|是否关闭分镜原声。 |
###|bgm_volume|number|背景乐音量，范围是[0, 100]。|
|request_id |string|请求的日志id，唯一标识一个请求。 |

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "20220624071802010245246039081FD421",
    "data": {
        "status": "SUCCESS",
        "material_package_id": "3361016942373889",
        "available_quota": 0,
        "error_msg": null,
        "videos": [
            {
                "url": "http://v16m-default.akamaized.net/6cd7e6da75783cc83daaad8b2f8e6ae1/62b5b99d/video/tos/alisg/tos-alisg-v-0000/5e3f7aa540a04969931c3620fd7cee98/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=484&bt=242&btag=80000&cs=0&ds=1&ft=uSV.Ng3-InzlkO0oABM&mime_type=video_mp4&qs=0&rc=OTk0ZTllOmlpOGlnZWZpOUBpampxNjk6ZmszZDMzODYzNEBeNjRjLTFfNTAxMl8uYjMwYSNjaW1ncjRnbm5gLS1kMC1zcw%3D%3D&l=2022062407180201024524424702000EEF",
                "music_id": "6989830756676960258",
                "slots": [
                    {
                        "tag": "asd",
                        "mute": true,
                        "bgm_volume": 100,
                        "order": 0,
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0"
                    }
                ],
                "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/cd27dc1363f541b39f5cd06959f77263",
                "video_id": "v10033g50000caq0qhjc77u6j3pnlgfg",
                "music_name": "Sleepmode",
                "duration": 19.538,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "width": 720
            },
            {
                "url": "http://v16m-default.akamaized.net/50010b1fab7474435054e71b79c747f6/62b5b99d/video/tos/alisg/tos-alisg-v-0000/5ca2a7dc601b4d26b24aace09301fbbb/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=484&bt=242&btag=80000&cs=0&ds=1&ft=uSV.Ng3-InzlkO0oABM&mime_type=video_mp4&qs=0&rc=NzszZTw6ZDZmNmZoOTM8aEBpM21sMzY6ZmszZDMzODYzNEAzYy0xL2I0XjAxXzAtMDEtYSMxXl4ycjRnbm5gLS1kMC1zcw%3D%3D&l=202206240718020102452430990E000101",
                "music_id": "6904872562267848706",
                "slots": [
                    {
                        "tag": "asd",
                        "mute": true,
                        "bgm_volume": 100,
                        "order": 0,
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0"
                    }
                ],
                "music_url": "https://sf16-sg-default.akamaized.net/obj/tiktok-obj/df3d4e1830a1128bdebf83bedac8df69.mp3",
                "video_id": "v10033g50000caq0qhjc77u350aiaj40",
                "music_name": "Happy and fun corporate music for advertising.",
                "duration": 19.525,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "width": 720
            },
            {
                "url": "http://v16m-default.akamaized.net/5aaab797e0dcc4306b0e27fd8a2b3eb3/62b5b99e/video/tos/alisg/tos-alisg-v-0000/6a26ca2b7f9448d68deef8bc4783b63f/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=484&bt=242&btag=80000&cs=0&ds=1&ft=uSV.Ng3-InzPkO0oABM&mime_type=video_mp4&qs=0&rc=aDZoN2Q1aThpOmk8NWVmPEBpam53NmY6ZmwzZDMzODYzNEAuNGFfX2MwX14xLi4zLl5iYSNgLy5fcjRfbm5gLS1kMC1zcw%3D%3D&l=2022062407180301024524804306000435",
                "music_id": "6836343392953384966",
                "slots": [
                    {
                        "tag": "asd",
                        "mute": true,
                        "bgm_volume": 100,
                        "order": 0,
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0"
                    }
                ],
                "music_url": "http://sf-tk-sg.ibytedtos.com/obj/cc-music-sg/6723099489072057095",
                "video_id": "v10033g50000caq0qibc77ucb31t2kcg",
                "music_name": "r&b loop",
                "duration": 19.544,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "width": 720
            }
        ]
    }
}
(/code);