AI 影片筆記
使用百度 AI 從影片網址生成結構化筆記。支援三種筆記格式。
工作流程
- 建立任務:提交影片網址 → 取得任務 ID
- 輪詢狀態:每 3–5 秒查詢任務,直到完成
- 取得結果:當狀態碼為 10002 時,擷取生成的筆記
狀態碼
| 狀態碼 | 狀態 | 動作 |
|---|---|---|
| 10000 | 處理中 | 繼續輪詢 |
| 10002 | 完成 | 回傳結果 |
| 其他 | 失敗 | 顯示錯誤 |
筆記類型
| 類型 | 描述 |
|---|---|
| 1 | 文件筆記 |
| 2 | 大綱筆記 |
| 3 | 圖文混合筆記 |
API
建立任務
端點:POST /v2/tools/ai_note/task_create
參數:
video_url(必填):公開的影片網址
範例:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
回應:
{
"task_id": "uuid-string"
}
查詢任務
端點:GET /v2/tools/ai_note/query
參數:
task_id(必填):從建立任務端點取得的任務 ID
範例:
python3 scripts/ai_notes_task_query.py "task-id-here"
回應(完成時):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents": ["筆記內容..."]
}
]
}
輪詢策略
選項一:手動輪詢
- 建立任務 → 儲存
task_id - 每 3–5 秒查詢一次:
python3 scripts/ai_notes_task_query.py <task_id> - 顯示進度更新:
- 狀態 10000:處理中...
- 狀態 10002:完成
- 在 30–60 秒後停止(取決於影片長度)
選項二:自動輪詢(建議)
使用輪詢腳本自動更新狀態:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
範例:
# 預設:20 次嘗試,間隔 3 秒
python3 scripts/ai_notes_poll.py "task-id-here"
# 自訂:30 次嘗試,間隔 5 秒
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
輸出:
- 即時顯示進度:
[1/20] 處理中... 25% - 完成時自動停止
- 回傳帶有類型標籤的格式化筆記
錯誤處理
- 無效的網址:「影片網址無法存取」
- 處理錯誤:「無法解析影片」
- 逾時:「影片過長,請稍後再試」