介绍
# AI Video Notes
使用百度 AI 从视频 URL 生成结构化笔记。支持三种笔记格式。
## 工作流程
1. **创建任务**：提交视频 URL → 获取任务 ID 2. **轮询状态**：每 3-5 秒查询一次任务，直到完成 3. **获取结果**：当状态 = 10002 时检索生成的笔记
## 状态码
| 代码 | 状态 | 操作 | |-------|---------|---------| | 10000 | 进行中 | 继续轮询 | | 10002 | 已完成 | 返回结果 | | 其他 | 失败 | 显示错误 |
## 笔记类型
| 类型 | 描述 | |------|-------------| | 1 | 文档笔记 | | 2 | 大纲笔记 | | 3 | 图文笔记 |
## API
### 创建任务
**端点**：`POST /v2/tools/ai_note/task_create`
**参数**： - `video_url`（必需）：公开的视频 URL
**示例**： ```bash python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4' ```
**响应**： ```json { "task_id": "uuid-string" } ```
### 查询任务
**端点**：`GET /v2/tools/ai_note/query`
**参数**： - `task_id`（必需）：来自创建端点的任务 ID
**示例**： ```bash python3 scripts/ai_notes_task_query.py "task-id-here" ```
**响应**（已完成）： ```json { "status": 10002, "notes": [ { "tpl_no": "1", "contents: ["Note content..."] } ] } ```
## 轮询策略
### 选项 1：手动轮询 1. 创建任务 → 保存 `task_id` 2. 每 3-5 秒查询一次： ```bash python3 scripts/ai_notes_task_query.py <task_id> ``` 3. 显示进度更新： - 状态 10000：处理中... - 状态 10002：已完成 4. 30-60 秒后停止（取决于视频长度）
### 选项 2：自动轮询（推荐） 使用轮询脚本自动获取状态更新：
```bash python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds] ```
**示例**： ```bash # 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] Processing... 25%` - 完成时自动停止 - 返回带有类型标签的格式化笔记
## 错误处理
- 无效 URL：“Video URL not accessible” - 处理错误：“Failed to parse video” - 超时：“Video too long, try again later”