（已废弃）获取异步任务结果
您可以使用本接口获取异步任务结果。
若任务已完成 （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);