ai-notes-of-video

视频AI笔记工具由百度提供。根据用户提供的视频下载地址，下载并解析视频，最终生成视频对应的AI笔记（共可生成三种类型的笔记：文档笔记、大纲笔记、图文笔记）。

# AI PPT Generation

This skill allows OpenClaw agents to generate AI notes, Based solely on the video address provided by the user.

## Setup

1.  **API Key:** Ensure the BAIDU_API_KEY environment variable is set with your valid API key.
2.  **Environment:** The API key should be available in the runtime environment.

## API table
|    name    |               path              |            description                |
|------------|---------------------------------|---------------------------------------|
|AINotesTaskCreate|/v2/tools/ai_note/task_create|Create AI notes task based on the video address provided by the user|
|AINotesTaskQuery| /v2/tools/ai_note/query   |Query AI notes task result based on task id|


## Workflow

1. The AINotesTaskCreate API executes the Python script located at `scripts/ai_notes_task_create.py`
2. The AINotesTaskQuery API executes the Python script located at `scripts/ai_notes_task_query.py`
3. The first step ,call the AINotesTaskCreate API to create a task and get the task ID, must give a video address.
4. The second step ,call the AINotesTaskQuery API to query the task result based on the task ID.
5. Repeat the second step until the task status is completed.The task success identifier is status=10002. status=10000 indicates that the task is in progress. All other status codes are failures
6. Each item in the note list is a note content. For each item in the list: the tpl_no field represents the type of stored notes, 1 - manuscript notes, 2 - outline notes, 3 - graphic and text notes. The "detail" field is for note details. In "detail", "status" represents the note status, with 10002 indicating success,with status=10000 indicating progressing and other status codes indicating failure. "content" indicates the note result. The mind map is located at the top of the outline note and is marked by the "Mind" tag

## APIS

### AINotesTaskCreate API 

#### Parameters

- `video_url`: the url of the video (required)

#### Example Usage
```bash
BAIDU_API_KEY=xxx python3 scripts/ai_notes_task_create.py 'https://xxxxx.bj.bcebos.com/1%E5%88%86%E9%92%9F_%E6%9C%89%E5%AD%97%E5%B9%95.mp4'
```

### PPTOutlineGenerate API 

#### Parameters

- `task_id`: task id from AINotesTaskCreate API return（required）


#### Example Usage
```bash
BAIDU_API_KEY=xxx python3 scripts/ai_notes_task_query.py "26943ed4-f5a9-4306-a05b-b087665433a0"
```

---

## 中文说明

# AI PPT Generation

此技能让 OpenClaw 代理能够仅根据用户提供的视频地址生成 AI 笔记。

## 设置

1.  **API 密钥：** 确保 BAIDU_API_KEY 环境变量已设置为你的有效 API 密钥。
2.  **环境：** API 密钥应在运行时环境中可用。

## API 表

|    名称    |               路径              |            说明                |
|------------|---------------------------------|---------------------------------------|
|AINotesTaskCreate|/v2/tools/ai_note/task_create|根据用户提供的视频地址创建 AI 笔记任务|
|AINotesTaskQuery| /v2/tools/ai_note/query   |根据任务 ID 查询 AI 笔记任务结果|


## 工作流程

1. AINotesTaskCreate API 执行位于 `scripts/ai_notes_task_create.py` 的 Python 脚本
2. AINotesTaskQuery API 执行位于 `scripts/ai_notes_task_query.py` 的 Python 脚本
3. 第一步，调用 AINotesTaskCreate API 创建任务并获取任务 ID，必须提供一个视频地址。
4. 第二步，调用 AINotesTaskQuery API 根据任务 ID 查询任务结果。
5. 重复第二步，直到任务状态为已完成。任务成功标识为 status=10002。status=10000 表示任务正在进行中。所有其他状态码均为失败。
6. 笔记列表中的每一项都是一条笔记内容。对于列表中的每一项：tpl_no 字段表示所存储笔记的类型，1 - 文稿笔记，2 - 大纲笔记，3 - 图文笔记。"detail" 字段为笔记详情。在 "detail" 中，"status" 表示笔记状态，10002 表示成功，status=10000 表示进行中，其他状态码表示失败。"content" 表示笔记结果。思维导图位于大纲笔记顶部，由 "Mind" 标签标记。

## APIS

### AINotesTaskCreate API 

#### 参数

- `video_url`：视频的 url（必填）

#### 用法示例
```bash
BAIDU_API_KEY=xxx python3 scripts/ai_notes_task_create.py 'https://xxxxx.bj.bcebos.com/1%E5%88%86%E9%92%9F_%E6%9C%89%E5%AD%97%E5%B9%95.mp4'
```

### PPTOutlineGenerate API 

#### 参数

- `task_id`：来自 AINotesTaskCreate API 返回的任务 id（必填）


#### 用法示例
```bash
BAIDU_API_KEY=xxx python3 scripts/ai_notes_task_query.py "26943ed4-f5a9-4306-a05b-b087665433a0"
```