AI视频笔记

使用百度AI，根据视频URL生成结构化笔记。支持三种笔记格式。

工作流程

1. 创建任务：提交视频URL → 获取任务ID
2. 轮询状态：每3-5秒查询一次任务状态，直至完成
3. 获取结果：当状态码 = 10002 时，检索生成的笔记

状态码

笔记类型

API接口

创建任务

端点：POST /v2/tools/ai_note/task_create

参数：

• video_url（必需）：公开视频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: ["Note content..."]
    }
  ]
}

轮询策略

选项 1：手动轮询

1. 创建任务 → 存储任务ID
2. 每 3-5 秒查询一次:

   python3 scripts/ai_notes_task_query.py <task_id>

3. 显示进度更新:
   • 状态 10000：正在处理...
   • 状态 10002：已完成
4. 30-60 秒后停止（取决于视频长度）

选项 2：自动轮询（推荐）

使用轮询脚本自动获取状态更新:

python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]

示例:

# Default: 20 attempts, 3-second intervals
python3 scripts/ai_notes_poll.py "task-id-here"

# Custom: 30 attempts, 5-second intervals
python3 scripts/ai_notes_poll.py "task-id-here" 30 5

输出:

• 显示实时进度:[1/20] 正在处理... 25%
• 完成时自动停止
• 返回带有类型标签的格式化笔记

错误处理

• 无效的URL："视频URL无法访问"
• 处理错误："解析视频失败"
• 超时："视频过长，请稍后再试"