minutes +upload

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

上传音视频文件到飞书妙记并生成妙记（Minute）。

本 skill 对应 shortcut：lark-cli minutes +upload。

典型触发表达

"把这个音视频文件转成妙记"
"把这个音视频文件转成纪要"
"把这个音视频文件转成逐字稿、文字稿或撰写文字"
"把这个音视频文件转成总结、待办或章节"

完整工作流

当用户要求将音视频文件转换为妙记，或进一步要纪要/逐字稿/文字稿/撰写文字时，必须按照以下步骤执行：

上传文件至云空间获取 file_token
- 使用 lark-cli drive +upload 命令上传本地文件到云空间（Drive）：
```
lark-cli drive +upload --file <path/to/media/file>
```
- 从命令的返回结果中提取生成的 file_token。
将 file_token 转换为妙记链接（minute_url）
- 调用本 shortcut，将获取到的 file_token 转换为妙记：
```
lark-cli minutes +upload --file-token <file_token>
```
- 命令执行成功后，将返回生成的妙记链接 minute_url。
如需纪要 / 逐字稿 / 文字稿 / 撰写文字，继续提取 minute_token 调用 vc +notes
- 从返回的 minute_url 中提取路径最后一段，得到 minute_token。
- 如果用户要的是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，继续调用：
```
lark-cli vc +notes --minute-tokens <minute_token>
```
- vc +notes --minute-tokens 会返回纪要文档、逐字稿文档，以及 AI 内置产物（总结、待办、章节）；必要时还会把逐字稿落地到本地文件。

异步生成提示：API 会立即返回 minute_url，但妙记可能仍在异步生成中，您可以直接通过该妙记链接查看当前的处理状态和转写结果。

命令示例

# 通过已上传到云空间的 file_token 生成妙记
lark-cli minutes +upload --file-token boxcnxxxxxxxxxxxxxxxx

# 通过 minute_token 继续获取纪要 / 逐字稿 / 文字稿 / AI 产物
lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx

参数

参数	必填	说明
`--file-token <token>`	是	已经上传到飞书云空间的音视频文件的 file_token

支持的格式与限制

待上传到妙记的原始音视频文件必须满足以下要求：

支持音频格式：wav、mp3、m4a、aac、ogg、wma、amr
支持视频格式：avi、wmv、mov、mp4、m4v、mpeg、ogg、flv
音视频时长不能超过 6 小时
文件大小不能超过 6 GB

说明：本 shortcut 只接收 file_token，不会直接读取本地文件内容，因此这些格式、时长和大小限制对应的是原始上传文件本身。若妙记生成失败，请先回查源文件是否满足上述要求。

核心约束

1. 必须提供 file_token

本接口不直接处理本地文件的上传，必须先使用 drive +upload 将文件上传到云空间获取 file_token，然后再调用本接口。

2. 先上传，再生成妙记

推荐流程如下：

使用 lark-cli drive +upload --file <path> 上传本地音视频文件到云空间
从返回结果中取出 file_token
调用 lark-cli minutes +upload --file-token <file_token> 生成妙记
如果目标是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，再从 minute_url 提取 minute_token，继续调用 lark-cli vc +notes --minute-tokens <minute_token>

边界说明：minutes +upload 本身只负责把文件转成妙记并返回 minute_url。纪要内容、逐字稿、文字稿、撰写文字、总结、待办、章节属于后续产物获取，应由 vc +notes 承接。

输出结果示例

{
  "minute_url": "http(s)://<host>/minutes/<minute-token>"
}

字段	说明
`minute_url`	生成的妙记访问链接

参考

lark-minutes -- 妙记相关功能说明
drive +upload -- 上传文件到云空间
lark-shared -- 认证和全局参数

4.3 KiB Raw Blame History Unescape Escape