集锦素材推荐

测试中

POST

/v2/ai/client/video_highlights/highlights

按时间范围查询指定设备适合生成视频集锦的推荐素材。

请求参数

Header 参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2/ai/client/video_highlights/highlights' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Platform: {{platform}}' \
--header 'X-Tg-Sdk-Version: 23910000' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'X-Tg-App-Pkgname: {{pkgname}}' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'X-Tg-Api-Version: 2.1' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "device-001",
    "time_range": {
        "start": 1710000000,
        "end": 1710003600
    },
    "count": 3
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "items": [
            {
                "event_id": "evt-1",
                "event_timestamp": 1710000100,
                "score": 9,
                "screened_url": "https://example.com/source.mp4",
                "screened_poster_url": "https://example.com/posters/source.jpg",
                "segment_url": "https://example.com/segment.mp4",
                "segment_poster_url": "https://example.com/posters/segment.jpg",
                "highlight_profile": "pet",
                "segment": {
                    "start_time": "00:01",
                    "end_time": "00:05",
                    "duration_seconds": 4,
                    "description": "宠物跳跃",
                    "score": 9,
                    "reason": "动作完整且画面清晰"
                }
            }
        ]
    }
}

🟠403PackageNotEnabled

🟠404AiAppNotFound

🟠422ValidationFailed

🔴502PackageValidationFailed

🔴503VideoHighlightsUnavailable

修改于 2026-04-30 13:27:41

查询集锦详情

AI事件检索