generate_note
Convert a video link or local file into AI-generated Markdown notes. Starts an async job, returns a task ID, and produces a portable note with optional screenshots and formats.
Instructions
提交一个视频链接/本地文件,异步生成 AI Markdown 笔记。
- video_url: 必填,B 站/YouTube/抖音/快手链接或本地文件路径;
- platform: 可省略,自动识别;
- quality: fast / medium / slow;
- provider_id: LLM 供应商 id(先 list_providers 查看,add_provider 新增);
- model_name: 省略时取已配置的默认模型(setup 向导设置),否则取该供应商第一个可用模型;
- format: 附加内容,如 ["toc","link","screenshot","summary"];
- style: 输出风格(minimal 精简/detailed 详细/academic 学术/tutorial 教程/xiaohongshu 小红书/life_journal 生活向/task_oriented 任务导向/business 商业风格/meeting_minutes 会议纪要);不传时用 setup ③ 配置的默认(默认 detailed);显式传入始终覆盖;
- extras: 附加到 prompt 末尾的自定义指令(如自定义笔记风格要求);内置风格用 style,自定义风格用 extras;
- include_comments / comments_limit: 是否抓取 B 站弹幕+热门评论作为参考注入 prompt(仅 B 站视频生效);不传时用 setup 默认(默认关 / 20 条);显式传入始终覆盖;
- video_understanding / video_interval / grid_size: 视频理解(需多模态模型);不传时用 setup ③ 配置的默认(默认关 / 6s);显式传入始终覆盖;
- screenshot + format 含 "screenshot": 插入图片,产出便携笔记 note.md + Assets/(相对引用);不传时用 setup ③ 配置的默认(默认关);显式传入始终覆盖;
- notes_dir: 便携笔记的输出目录(可选;缺省 BILINOTE_NOTES_DIR 环境变量,再缺省 note_results/{task_id}/)。
返回 {task_id, status, platform}。之后用 get_task_status / wait_for_note 查询结果;
SUCCESS 时 result.note_dir 指向便携笔记目录。
只需素材(转写/帧/评论,不调 LLM 总结)供自行写笔记时,用 prepare_note_material。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | ||
| style | No | ||
| extras | No | ||
| format | No | ||
| quality | No | medium | |
| platform | No | ||
| grid_size | No | ||
| notes_dir | No | ||
| video_url | Yes | ||
| model_name | No | ||
| screenshot | No | ||
| provider_id | No | ||
| comments_limit | No | ||
| video_interval | No | ||
| include_comments | No | ||
| video_understanding | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |