跳转到内容

录制内容

用于录制、转写内容和分享链接的端点。所有路径都位于 https://api.recordmeeting.com,并且需要 API 密钥。请参阅身份验证。

GET /v1/recordings

返回你有权访问的录制的分页列表。

参数类型默认值说明
limitinteger20结果数量(1 到 100)
offsetinteger0分页偏移量
searchstring无按标题中的文本筛选
statusstring无按状态筛选(见录制状态)
date_fromstring无ISO 8601 日期时间。仅返回在该时间当天或之后创建的录制
date_tostring无ISO 8601 日期时间。仅返回在该时间当天或之前创建的录制
organization_idstring无列出某个组织的录制
folder_idstring无列出某个文件夹中的录制
user_idstring无按用户筛选。适用于想查看某个成员录制的组织管理员
{
"data": [
{
"id": "uuid",
"title": "Weekly sync",
"status": "COMPLETED",
"created_at": "2026-09-19T15:00:00.000Z",
"duration_seconds": 1740,
"thumbnail_url": "https://...",
"folder_id": null,
"organization_id": null,
"transcription_status": "completed",
"notes_status": "completed",
"is_shared": true,
"processing_progress": null
}
],
"pagination": {
"total": 42,
"limit": 20,
"offset": 0,
"has_more": true
}
}

title、duration_seconds、thumbnail_url、folder_id、organization_id、transcription_status、notes_status 和 processing_progress 都可能为 null。对于已锁定的录制,transcription_status 和 notes_status 为 null。

使用 organization_id 时,编辑者和查看者只会得到他们被允许看到的录制。此时 total 是上限值,一页中的条目可能少于 limit 条。

错误:400 VALIDATION_ERROR;当你无权列出该组织的录制时返回 403 FORBIDDEN。


GET /v1/recordings/:id

返回单个录制的完整详情。

组织录制会返回给任何有权查看它的成员。所有者和管理员可以打开其组织中的每个录制。编辑者和查看者只能看到其角色和文件夹所允许的内容。对于组织录制,is_locked、download_url 和 capabilities 取决于组织的套餐和该成员的功能访问权限,而非你的个人套餐。

{
"data": {
"id": "uuid",
"title": "Weekly sync",
"status": "COMPLETED",
"created_at": "2026-09-19T15:00:00.000Z",
"updated_at": "2026-09-19T15:30:00.000Z",
"started_at": "2026-09-19T15:01:00.000Z",
"ended_at": "2026-09-19T15:30:00.000Z",
"duration_seconds": 1740,
"thumbnail_url": "https://...",
"download_url": "https://...",
"download_url_expires_at": "2026-09-19T21:30:00.000Z",
"folder_id": null,
"organization_id": null,
"processing_progress": null,
"transcription": {
"status": "completed",
"language": "en",
"speakers": ["Alice", "Bob"],
"segments_count": 184
},
"notes": "## Key topics\n...",
"notes_status": "completed",
"notes_truncated": false,
"sharing": {
"is_shared": true,
"share_url": "https://recordmeeting.com/app/shared/abc123"
},
"participants": [
{
"id": "participant_id",
"displayName": "Alice",
"email": "alice@example.com",
"source": "calendar",
"isOrganizer": true,
"mappedSpeaker": "Alice",
"avatarUrl": null
}
],
"media_type": "video",
"is_locked": false,
"open_url": "https://recordmeeting.com/app/recording/uuid",
"media": {
"hls_url": "https://...",
"direct_url": "https://...",
"expires_at": "2026-09-19T21:30:00.000Z"
},
"capabilities": {
"canDownload": true,
"canShare": true,
"canViewTranscription": true,
"canStartTranscription": true,
"canRegenerateTranscription": false,
"canRenameSpeaker": true,
"canReplaceText": true,
"canViewSummary": true,
"canGenerateSummary": true,
"canAskQuestions": true,
"canGenerateArtifacts": true
}
}
}
字段说明
notesMarkdown 格式的会议纪要。没有纪要或录制已锁定时为 null
download_url临时下载链接。除非 capabilities.canDownload 为 true,否则为 null。它在 download_url_expires_at 时到期
media临时播放链接。expires_at 过后请重新请求该录制
media_typevideo 或 audio
is_locked录制被锁定时为 true。此时 transcription 和 notes 为 null
open_url该录制在 Web 应用中的页面
sharing.share_url该录制的分享链接,没有分享链接时为 null

错误:404 RECORDING_NOT_FOUND;当组织的企业版订阅不再有效时返回 402 ORGANIZATION_SUBSCRIPTION_EXPIRED。


GET /v1/recordings/:id/transcript

以片段形式返回录制的转写内容,并按块(chunk)分页。

组织录制遵循与获取单个录制相同的访问规则。尚无转写内容的录制仍会返回 200,其中 "status": "not_started",且 segments 数组为空。

参数类型默认值说明
start_chunkinteger0要返回的第一个块的索引
limitinteger50块的数量(1 到 100)
{
"data": {
"status": "completed",
"language": "en",
"speakers": ["Alice", "Bob"],
"duration": 1740.5,
"segments": [
{
"id": 1,
"start": 0.5,
"end": 3.2,
"text": "Good morning everyone.",
"speaker": "Alice",
"confidence": 0.97
}
],
"pagination": {
"total_chunks": 4,
"has_more": true
}
}
}

start 和 end 以秒为单位。speaker 和 confidence 可以为 null。当 has_more 为 true 时,用更大的 start_chunk 请求下一页。

错误:录制已锁定时返回 403 RECORDING_LOCKED;组织或成员已禁用转写功能时返回 403 TRANSCRIPT_NOT_AVAILABLE;完整转写内容需要付费套餐时返回 403 SUBSCRIPTION_REQUIRED;404 RECORDING_NOT_FOUND;402 ORGANIZATION_SUBSCRIPTION_EXPIRED。


PATCH /v1/recordings/:id

重命名录制、替换其会议纪要,或两者同时进行。至少需要提供一个字段。

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
字段说明
title1 到 500 个字符
notesMarkdown 格式的会议纪要,最多 100,000 个字符。会替换现有的纪要

204 No Content,响应体为空。

错误:400 VALIDATION_ERROR、404 RECORDING_NOT_FOUND。


DELETE /v1/recordings/:id

永久删除一个录制及其所有数据:转写内容、会议纪要和分享链接。

204 No Content,响应体为空。

错误:404 RECORDING_NOT_FOUND。


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

创建录制的公开分享链接,或替换它已有的分享链接。之前的链接将停止工作。

对于组织录制,任何能查看该录制的成员都可以创建链接。该链接以录制所有者的名义创建,并使用组织的套餐。

{
"permission": "view"
}
取值说明
view拥有链接的人可以观看该录制
download拥有链接的人还可以下载该录制
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

错误:400 VALIDATION_ERROR;录制暂时无法分享时返回 400 RECORDING_NOT_READY;403 RECORDING_LOCKED;组织或成员已禁用分享功能时返回 403 SHARING_DISABLED;该权限需要付费套餐时返回 403 SUBSCRIPTION_REQUIRED;404 RECORDING_NOT_FOUND;402 ORGANIZATION_SUBSCRIPTION_EXPIRED。


状态说明
STARTING正在准备录制
CONNECTING正在连接会议
WAIT_APPROVAL等待录制批准
RECORDING正在录制
STALE录制在完成前停止发送数据
UPLOADING录制已停止,但仍在后台上传
PROCESSING视频正在处理,暂时无法播放
MIGRATING视频在迁移到长期存储期间仍可播放
COMPLETED录制已完全处理
ERROR录制失败