批量获取AI视频总结任务
更新时间:2025-03-24
接口描述
该接口用于批量获取AI视频总结任务结果
请求地址
https://spark.bokecc.com/api/video/summary/info
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
userid |
String |
是 |
用户ID。 |
videoids |
String |
是 |
视频ID。多个以英文逗号分隔,最多100个。 |
请求示例
https://spark.bokecc.com/api/video/summary/info?format=json&time=1671375717355&userid=CC443A66867376BF&videoids=6D080640AF53B5D363835A29B2A119xxx%2C6D080640AF53B5D3753C612EB38A8Dxxx&hash=EB75C455F8F426D08E428A7235C3E86E
返回数据
data是一个数组,每条记录表示一个视频的AI总结数据。
字段名 |
字段类型 |
说明 |
videoId |
String |
视频ID,加密长格式。 |
status |
Integer |
AI总结状态。0=生成中;1=成功;-1=失败;-2=未生成。 |
createTime |
String |
创建时间,格式:yyyy-MM-dd HH:mm:ss。status!=-2时返回。 |
finishTime |
String |
完成时间,格式:yyyy-MM-dd HH:mm:ss。status=1或-1时返回。 |
result |
Object |
AI总结结果。status=1时返回。 |
result说明
字段名 |
字段类型 |
说明 |
originalText |
String |
原文字幕结果文件链接。 |
autoChapters |
String |
章节预览结果文件链接。 |
summarization |
String |
全文摘要结果文件链接。 |
- originalText、autoChapters、summarization等链接文件内容都是JSON格式。
originalText说明
originalText链接文件内容是JSONArray格式,示例如下:
[{
"ParagraphId": "1740563831269500000",
"SpeakerId": "1",
"Words": [{
"Id": 10,
"SentenceId": 1,
"Start": 70,
"End": 718,
"Text": "大家好,"
},
{
"Id": 20,
"SentenceId": 1,
"Start": 860,
"End": 1087,
"Text": "有"
},
...
]
},
...
]
字段名 |
字段类型 |
说明 |
ParagraphId |
String |
段落级别的ID,用来区分段落 |
SpeakerId |
String |
发言人ID,用于区分发言人。本期未支持识别发言人能力,此项无意义。 |
Words |
Array |
当前段落中包含的字幕内容列表。字幕为词级别结果。 |
Words说明
字段名 |
字段类型 |
说明 |
Id |
Integer |
单词ID,表示序号。 |
SentenceId |
Integer |
句子ID,标识单词归属的句子,可以依此将属于同一句子ID的单词字幕按ID顺序组装成一句话。 |
Start |
Long |
单词字幕开始时间戳(相对音频开始时间),单位:ms。 |
End |
Long |
单词字幕结束时间戳(相对音频开始时间),单位:ms。 |
Text |
String |
单词字幕文本内容。 |
autoChapters说明
autoChapters链接文件内容是JSONArray格式,示例如下:
[
{
"Id": 1,
"Start": 70,
"End": 135490,
"Headline": "大学人际交往:用温暖的语言搭建理解桥梁",
"Summary": "本章节重点探讨了大学人际交往中语言表达的重要性,强调了温暖和尊重的语言能够增进理解与信任,而冷漠或恶言则可能破坏人际关系。"
},
...
]
字段名 |
字段类型 |
说明 |
Id |
Integer |
章节ID,表示序号。 |
Start |
Long |
章节开始时间戳(相对音频开始时间),单位:ms。 |
End |
Long |
章节结束时间戳(相对音频开始时间),单位:ms。 |
Headline |
String |
章节一句话标题。 |
Summary |
String |
章节总结内容。 |
summarization说明
summarization链接文件内容是JSONObject格式,示例如下:
{
"ParagraphSummary": "主讲人强调大学同学作为人生重要资源的价值,指出在大学环境中学会与不同类型的人建立良好关系对学生的个人成长和全面发展至关重要......"
}
字段名 |
字段类型 |
说明 |
ParagraphSummary |
String |
全文摘要内容。 |
返回示例
{
"subtitles": [
{
"videoId": "xxxxxx",
"status": 1,
"createTime": "2025-02-27 17:57:22",
"finishTime": "2025-02-27 18:00:02",
"result": {
"originalText": "https://xxxxxxx.json?xxxxx",
"autoChapters": "https://xxxxxxx.json?xxxxx",
"summarization": "https://xxxxxxxx.json?xxxxx"
}
},
{
"videoId": "xxxxxx",
"status": -1,
"createTime": "2025-02-27 17:57:22",
"finishTime": "2025-02-27 18:00:02"
},
{
"videoId": "xxxxxx",
"status": 0,
"createTime": "2025-02-27 17:57:22"
},
{
"videoId": "xxxxx",
"status": -2
},
...
]
}