# 创建妙记片段
基于一篇已完成的妙记及指定的时间范围，创建一篇新的妙记片段。接口成功响应表示妙记片段已提交创建，不代表文字记录和媒体文件已生成完成，文字记录和媒体文件将在后台异步生成。
**注意事项**：- 妙记必须存在、已生成完成、不在回收站中且不能处于审核失败状态。
- 妙记片段不能继续创建子片段。
- 调用用户必须拥有创建该妙记片段的权限，并通过数据访问控制检查。
- 妙记所有者必须有足够的存储空间。
- 每个时间范围必须大于 1000 毫秒；重叠或相邻范围会被合并。
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/minutes/v1/minutes/:minute_token/clip
HTTP Method | POST
接口频率限制 | [5 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 创建妙记片段(minutes:minutes.clip:write)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 路径参数
名称 | 类型 | 描述
---|---|---
minute_token | string | 妙记唯一标识。可从妙记的 URL 链接中获取，一般为最后一串字符：https://sample.feishu.cn/minutes/obcnq3b9jl72l83w4f14xxxx
**示例值**："obcnq3b9jl72l83w4f14xxxx"
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
time_ranges | time_range\[\] | 是 | 片段时间区间（可填写多个区间，会拼接成一个妙记片段）
**数据校验规则**：
- 长度范围：`1` ～ `50`
start_time | string | 否 | 起始时间（毫秒）
**示例值**："1000"
end_time | string | 否 | 截止时间（毫秒）
**示例值**："20000"
title | string | 否 | 片段标题（不填则生成默认标题）
**示例值**："快速上手飞书妙记-片段"
### 请求体示例
```json
{
"time_ranges": [
{
"start_time": "1000",
"end_time": "20000"
}
],
"title": "快速上手飞书妙记-片段"
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
minute_url | string | 妙记链接
### 响应体示例
```json
{
"code": 0,
"msg": "success",
"data": {
"minute_url": "https://sample.feishu.cn/minutes/obcnq3b9jl72l83w4f14xxxx"
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 2091001 | param is invalid | 检查请求参数的类型或格式是否与接口要求一致
404 | 2091002 | minutes not found | 妙记不存在，请检查输入参数是否正确
400 | 2091003 | minute not ready, try later | 妙记未生成完成，请等待妙记生成完成后重试
400 | 2091004 | minutes deleted | 妙记已被删除，请检查妙记状态是否正常。
403 | 2091005 | permission deny | 没有创建该妙记片段的权限，请联系妙记所有者开通权限
500 | 2091006 | service internal error | 服务端内部错误，请稍后重试。若重试后问题仍然存在，请联系飞书技术支持。官方联系链接：https://applink.feishu.cn/TLJpeNdW
400 | 2091007 | storage quota not enough | 检查云存储空间是否充足，如果额度不足，请联系管理员补充额度
403 | 2091103 | review status not allow | 妙记审核不通过，请检查妙记状态是否正常。