影片大綱回調通知說明

更新時間：2026-08-12 09:50:58

功能說明

在影片大綱任務相關處理環節（如影片大綱任務分析成功、分析失敗等）觸發後，系統會將此時影片大綱任務的狀態，透過 HTTP 方式回調給客戶的服務，以便了解任務的處理進度。

建立影片大綱 API

其他說明

對回調介面回應 HTTP 狀態碼 200，視為本次回調成功，後續不會發起回調重試。
對回調介面回應的 HTTP 狀態碼非 200，視為本次回調失敗，後續會發起回調重試，但最多只會重試 3 次，三次重試仍失敗後將不會再觸發當前事件的回調。

回調配置

回調配置路徑

有配置回調 URL 的使用者，才會發送回調請求。

回調事件類型

一、影片大綱任務處理成功

事件描述：影片大綱分析完成後，會觸發影片大綱任務處理成功回調事件。
HTTP 請求方式為：POST。
HTTP 請求參數格式：application/json

回調參數

名稱	類型	必填	描述
sign	string	是	詳見（影片大綱回調簽名參數說明）
timestamp	long	是	當前事件觸發時的時間，格式為 13 位時間戳
callbackType	string	是	回調類型，固定值 generate_success
taskId	long	是	字幕任務 ID
vid	string	是	影片 ID
outlineInfo	string	是	影片大綱資訊，詳細欄位說明請參考下方的 "outlineInfo 欄位說明"

outlineInfo 欄位說明

參數名	類型	說明
summary	List	總結內容，詳細欄位說明請參考下方的 "summary 欄位說明"
badwords	List	觸發的嚴禁詞列表
questions	List	問答的資料列表
introduction	String	整個影片的摘要資訊

summary 欄位說明

參數名	類型	說明
id	long	任務 ID
title	string	分段標題
startTime	string	開始時間點
endTime	string	結束時間點
keyword	List	涉及的關鍵詞列表
summary	List	分段的摘要資訊列表
endIndex	long	結束的字幕行號
startIndex	long	開始的字幕行號

回調範例

https://demo-callback.com/video-outline-task/callback/test

{
  "sign": "02EAD645ED22A87B35A9818BDE24A884125267C7",
  "timestamp": 1683622364265,
  "callbackType": "generate_success",
  "taskId": 30,
  "vid": "d561fac50f0eeab9589e8bfa4e08c2b4_c",
  "outlineInfo": 
    {
      "summary": [
        {
          "id": 160628,
          "title": "没有没有",
          "endTime": "00:00:08,780",
          "keyword": [
            "否定",
            "拒绝"
          ],
          "summary": [
            "说话者表示否定或拒绝"
          ],
          "endIndex": 0,
          "startTime": "00:00:08,220",
          "startIndex": 0
        }
      ],
      "badwords": [],
      "questions": [],
      "introduction": "本视频从00:00:08开始，对话正式开启。视频内容简短，主要包含对话开始部分，关键词为'没有'。"
    }
  }

二、影片大綱任務處理失敗

事件描述：在處理影片產生字幕的過程中，某個操作步驟失敗會觸發此回調。
HTTP 請求方式為：POST。
HTTP 請求參數格式：application/json

回調參數

名稱	類型	必填	描述
sign	string	是	詳見（影片大綱回調簽名參數說明）
timestamp	long	是	當前事件觸發時的時間，格式為 13 位時間戳
callbackType	string	是	回調類型，固定值 generate_fail
taskId	long	是	字幕任務 ID
vid	string	是	影片 ID

回調範例

https://demo-callback.com/video-outline-task/callback/test

{
    "sign": "02EAD645ED22A87B35A9818BDE24A884125267C7",
    "timestamp": 1683622364265,
    "callbackType": "generate_fail",
    "taskId": 30,
    "vid": "c560fac50f0eeab9589e8bfa4e08c2b4_c",
}

影片大綱回調簽名參數說明

校驗簽名（sign）參數可以有效避免收到偽造的回調請求，請對接了影片大綱任務回調的使用者務必校驗簽名參數是否正確，以免造成不必要的麻煩。

簽名產生規則

對字串 (secretKey + timestamp + timestamp + secretKey) 做 SHA1 加密。例如 SHA1( mySecretKey16836223642651683622364265mySecretKey)
把 SHA1 加密後的字串轉成大寫

其中 timestamp 是 13 位時間戳，會在回調介面的請求參數中取得，使用者的 secretKey 可以在設定 --> API 介面中查看。