118 lines
2.5 KiB
Markdown
118 lines
2.5 KiB
Markdown
|
---
|
|||
|
|
name: ai-notes-ofvideo
|
|||
|
|
description: "从视频生成AI驱动的笔记（文档、大纲或图文格式）。"
|
|||
|
|
metadata: { "openclaw": { "emoji": "📺", "requires": { "bins": ["python3"], "env":["BAIDU_API_KEY"]},"primaryEnv":"BAIDU_API_KEY" } }
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# AI Video Notes
|
|||
|
|
|
|||
|
|
Generate structured notes from video URLs using Baidu AI. Supports three note formats.
|
|||
|
|
|
|||
|
|
## Workflow
|
|||
|
|
|
|||
|
|
1. **Create Task**: Submit video URL → get task ID
|
|||
|
|
2. **Poll Status**: Query task every 3-5 seconds until completion
|
|||
|
|
3. **Get Results**: Retrieve generated notes when status = 10002
|
|||
|
|
|
|||
|
|
## Status Codes
|
|||
|
|
|
|||
|
|
| Code | Status | Action |
|
|||
|
|
|-------|---------|---------|
|
|||
|
|
| 10000 | In Progress | Continue polling |
|
|||
|
|
| 10002 | Completed | Return results |
|
|||
|
|
| Other | Failed | Show error |
|
|||
|
|
|
|||
|
|
## Note Types
|
|||
|
|
|
|||
|
|
| Type | Description |
|
|||
|
|
|------|-------------|
|
|||
|
|
| 1 | Document notes |
|
|||
|
|
| 2 | Outline notes |
|
|||
|
|
| 3 | Graphic-text notes |
|
|||
|
|
|
|||
|
|
## APIs
|
|||
|
|
|
|||
|
|
### Create Task
|
|||
|
|
|
|||
|
|
**Endpoint**: `POST /v2/tools/ai_note/task_create`
|
|||
|
|
|
|||
|
|
**Parameters**:
|
|||
|
|
- `video_url` (required): Public video URL
|
|||
|
|
|
|||
|
|
**Example**:
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Response**:
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"task_id": "uuid-string"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Query Task
|
|||
|
|
|
|||
|
|
**Endpoint**: `GET /v2/tools/ai_note/query`
|
|||
|
|
|
|||
|
|
**Parameters**:
|
|||
|
|
- `task_id` (required): Task ID from create endpoint
|
|||
|
|
|
|||
|
|
**Example**:
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/ai_notes_task_query.py "task-id-here"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Response** (Completed):
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"status": 10002,
|
|||
|
|
"notes": [
|
|||
|
|
{
|
|||
|
|
"tpl_no": "1",
|
|||
|
|
"contents: ["Note content..."]
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Polling Strategy
|
|||
|
|
|
|||
|
|
### Option 1: Manual Polling
|
|||
|
|
1. Create task → store `task_id`
|
|||
|
|
2. Query every 3-5 seconds:
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/ai_notes_task_query.py <task_id>
|
|||
|
|
```
|
|||
|
|
3. Show progress updates:
|
|||
|
|
- Status 10000: Processing...
|
|||
|
|
- Status 10002: Completed
|
|||
|
|
4. Stop after 30-60 seconds (video length dependent)
|
|||
|
|
|
|||
|
|
### Option 2: Auto Polling (Recommended)
|
|||
|
|
Use the polling script for automatic status updates:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Examples**:
|
|||
|
|
```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
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Output**:
|
|||
|
|
- Shows real-time progress: `[1/20] Processing... 25%`
|
|||
|
|
- Auto-stops when complete
|
|||
|
|
- Returns formatted notes with type labels
|
|||
|
|
|
|||
|
|
## Error Handling
|
|||
|
|
|
|||
|
|
- Invalid URL: "Video URL not accessible"
|
|||
|
|
- Processing error: "Failed to parse video"
|
|||
|
|
- Timeout: "Video too long, try again later"
|