录制

列出录制

GET /api/v1/recordings

返回经过身份验证的用户可访问的录制的分页列表。

查询参数

参数	类型	默认值	描述
limit	number	20	结果数量 (1–100)
offset	number	0	分页偏移量
search	string	-	按标题筛选 (部分匹配)
status	string	-	按状态筛选 (参见 录制状态)
date_from	string	-	ISO 8601 日期 - 仅返回在此日期或之后创建的录制
date_to	string	-	ISO 8601 日期 - 仅返回在此日期或之前创建的录制
organization_id	string	-	限制到某个组织
folder_id	string	-	限制到某个文件夹 (需要 organization_id)

响应

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "每周同步",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

---

获取录制

GET /api/v1/recordings/:id

返回单个录制的完整详细信息。

组织录制可供任何允许查看它们的组织成员使用。所有者和管理员可以打开其组织中的每个录制；编辑者和查看者可以看到其角色和文件夹访问权限允许的录制。对于组织录制，is_locked、download_url 和 capabilities 反映组织计划和成员的功能标志，而不是调用者的个人计划。

当组织的 Enterprise 订阅不再激活时，返回 402 ORGANIZATION_SUBSCRIPTION_EXPIRED。

响应

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "每周同步",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["发言人 1", "发言人 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## 主要议题\n...",
      "topics": [
        {
          "title": "项目时间表",
          "keyPoints": [
            { "point": "发布日期已确认", "details": ["定于第一季度"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

---

获取转录片段

GET /api/v1/recordings/:id/transcript

返回录制的分页转录片段。

组织录制遵循与 获取录制 相同的访问规则。当录制被锁定且组织的转录被禁用或成员无法访问时，返回 403 RECORDING_LOCKED 和 403 TRANSCRIPT_NOT_AVAILABLE。尚未转录的录制仍会返回 200，其中 "status": "not_started" 且 segments 数组为空。

查询参数

参数	类型	默认值	描述
start_chunk	number	0	开始的块索引
limit	number	50	块的数量 (1–100)

响应

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["发言人 1", "Alice"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "大家早上好。",
        "speaker": "Alice",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

---

更新录制

PATCH /api/v1/recordings/:id

更新录制的标题或备注。至少需要一个字段。

请求体

{
  "title": "新标题 (1–500 个字符)",
  "notes": "可选备注 (最多 100,000 个字符)"
}

响应

{
  "data": { "success": true }
}

---

删除录制

DELETE /api/v1/recordings/:id

永久删除录制及其所有相关数据 (转录、摘要、分享)。

响应

{
  "data": { "success": true }
}

危险

删除是永久性的，无法撤销。

---

创建分享链接

POST /api/v1/recordings/:id/share-link

为录制生成一个公共分享链接。

对于组织录制，任何可以查看录制的成员都可以创建链接。该链接是代表录制所有者创建的，并使用组织的计划，因此即使调用者的个人计划是免费的，download 链接也适用于组织录制。当录制被锁定且组织的共享被禁用或成员无法访问时，返回 403 RECORDING_LOCKED 和 403 SHARING_DISABLED。

请求体

{
  "permission": "view"
}

值	描述
view	收件人可以观看视频并访问转录/摘要
download	收件人还可以下载视频文件

响应

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

---

录制状态

状态	描述
STARTING	已收到录制请求，正在进行设置
CONNECTING	正在连接到 Google Meet 会话
WAIT_APPROVAL	正在等待通话中批准录制
RECORDING	正在积极录制
UPLOADING	客户端上传正在进行中 (数据块正在传输到存储)
PROCESSING	Cloudflare Stream 正在打包 HLS/DASH - 尚未可播放
MIGRATING	视频完全可播放；HLS 正在迁移到长期存储
COMPLETED	录制已完全处理和存储
ERROR	录制失败

API 消费者应将 MIGRATING 与 COMPLETED 视为相同，用于播放、下载和共享操作 - 其区别仅限于内部。