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": ["笔记内容..."]
}
]
}
轮询策略
方案 1:手动轮询
- 创建任务 → 保存
task_id - 每 3-5 秒查询一次:
python3 scripts/ai_notes_task_query.py <task_id> - 显示进度更新:
- 状态 10000:处理中...
- 状态 10002:已完成
- 30-60 秒后停止(取决于视频长度)
方案 2:自动轮询(推荐)
使用轮询脚本自动更新状态:
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% - 完成后自动停止
- 返回带有类型标签的格式化笔记
错误处理
- 无效链接:"视频链接无法访问"
- 处理错误:"视频解析失败"
- 超时:"视频过长,请稍后重试"