← 返回目录
📁 API Reference › (Deprecated) Dynamic Scene

(已废弃)获取视频

您可以使用本接口获取某个素材包下的所有视频。

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

v1.2与v1.3版本对比

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


## 请求

**地址**

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

**方法** GET

**Header**

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

参数

|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主ID。 |
|material_package_id {必填}|string|素材包ID。|
| page | number | 您要查看的页面。 |
| page_size | number | 每页包含的结果数量。默认值:10。 |

返回

|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|list|object[]|素材包下生成的视频。|
##|video_id|string|视频ID。 |
##|video_preview_url|string|视频预览链接。|
##|music_id|string|音乐ID。|
##|music_name|string|音乐名称。|
##|music_preview_url |string|音乐预览链接。 |
##|width|number| 视频宽度。|
##|height|number| 视频长度。|
##|duration|number|视频时长(秒)。|
##|story_arc|string[]|故事线。故事线中可包括多个槽位。|
##|slots |object[]|槽位信息。|
###|order |number|槽位在故事线的顺序,范围:0-5。|
###|tag |string|槽位的标签。|
###|video_ids|string[]|视频素材ID。|
###|mute|boolean|是否关闭槽位原声。 |
###|bgm_volume|number|背景乐音量,范围:[0, 100]。|
#|page_info|object| 页面信息。 |
##|page |number| 当前页码。 |
##|page_size |number| 页面大小。 |
##|total_number |number| 总结果数。|
##|total_page |number| 总结果页数。 |
|request_id |string|请求的日志id,唯一标识一个请求。 |

示例

(code Success-Response http)
{
    "code": 0,
    "message": "OK",
    "request_id": "202206240324350102452421632116E80F",
    "data": {
        "list": [
            {
                "width": 720,
                "video_id": "v10033g50000caq0qhjc77u6j3pnlgfg",
                "music_id": "6989830756676960258",
                "url": "http://v16m-default.akamaized.net/17eb07f08a57b5308cba3e75f765cb9f/62b582e6/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-InzuW60oABM&mime_type=video_mp4&qs=0&rc=OTk0ZTllOmlpOGlnZWZpOUBpampxNjk6ZmszZDMzODYzNEBeNjRjLTFfNTAxMl8uYjMwYSNjaW1ncjRnbm5gLS1kMC1zcw%3D%3D&l=202206240324350102440292020C017708",
                "duration": 19.538,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "music_preview_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/cd27dc1363f541b39f5cd06959f77263",
                "slots": [
                    {
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0",
                        "tag": "asd",
                        "bgm_volume": 100,
                        "order": 0,
                        "mute": true
                    }
                ],
                "music_name": "Sleepmode"
            },
            {
                "width": 720,
                "video_id": "v10033g50000caq0qhjc77u350aiaj40",
                "music_id": "6904872562267848706",
                "url": "http://v16m-default.akamaized.net/1a55f60bba00a1c87d9ce5ce71ba34b4/62b582e6/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-InzuW60oABM&mime_type=video_mp4&qs=0&rc=NzszZTw6ZDZmNmZoOTM8aEBpM21sMzY6ZmszZDMzODYzNEAzYy0xL2I0XjAxXzAtMDEtYSMxXl4ycjRnbm5gLS1kMC1zcw%3D%3D&l=202206240324350102450241122701B0C6",
                "duration": 19.525,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "music_url": "https://sf16-sg-default.akamaized.net/obj/tiktok-obj/df3d4e1830a1128bdebf83bedac8df69.mp3",
                "slots": [
                    {
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0",
                        "tag": "asd",
                        "bgm_volume": 100,
                        "order": 0,
                        "mute": true
                    }
                ],
                "music_name": "Happy and fun corporate music for advertising."
            },
            {
                "width": 720,
                "video_id": "v10033g50000caq0qibc77ucb31t2kcg",
                "music_id": "6836343392953384966",
                "url": "http://v16m-default.akamaized.net/bd02bf656197a57cd15bbeb726c13815/62b582e7/video/tos/alisg/tos-alisg-v-0000/b5b57cfbef854605a62e36f60cf2dd77/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=1394&bt=697&btag=80000&cs=0&ds=3&ft=uSV.Ng3-InzXW60oABM&mime_type=video_mp4&qs=0&rc=aWk4NzczMzs8N2Y5Zzg8PEBpam53NmY6ZmwzZDMzODYzNEAuXjNjNTUtXjYxLjJiYTJgYSNgLy5fcjRfbm5gLS1kMC1zcw%3D%3D&l=2022062403243601025105814402017216",
                "duration": 19.544,
                "story_arc": [
                    "asd"
                ],
                "height": 1280,
                "music_url": "http://sf-tk-sg.ibytedtos.com/obj/cc-music-sg/6723099489072057095",
                "slots": [
                    {
                        "video_id": "v10e84g50000c2ee7s5gt180ugq54gm0",
                        "tag": "asd",
                        "bgm_volume": 100,
                        "order": 0,
                        "mute": true
                    }
                ],
                "music_name": "r&b loop"
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 100,
            "total_page": 1,
            "total_number": 3
        }
    }
}
(/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 每日平台更新简报 →