# 录制字幕 (/zh-CN/realtime-media/speech-to-text/build/process-transcription-data/record-captions)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
实时转录翻译支持录制字幕文本,生成 .vtt 文件并保存到配置的云存储中。
录制的字幕可与音视频录制文件同步播放,也可用于生成会议纪要与主题摘要、情感分析和内容审核。录制字幕不收取额外费用。
本文介绍如何录制字幕,并将字幕与云端录制生成的音视频文件同步。
:::warning[注意]
云端录制与转写任务运行在不同服务器上,要同步时间戳,必须在云端录制中开启 NTP 时间戳。
:::
## 前提条件 [#前提条件]
开始前,请确保你的开发环境满足以下条件:
- 参考[开通服务](/zh-CN/realtime-media/speech-to-text/build/start-transcribing-and-translating/enable-service)在声网控制台开通实时转录翻译服务,并复制保存 App ID、临时 Token、客户 ID 和客户密钥,以供后续使用。
- 可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考[应对防火墙限制](/zh-CN/realtime-media/rtc/build/setup-and-access/firewall)以正常使用声网服务。
- 集成并使用声网 [实时互动 RTC SDK](/zh-CN/realtime-media/rtc/get-started/quick-start) 搭建一个极简的实时音视频互动 App。
- 参考[实现 HTTP 基本认证](/zh-CN/realtime-media/speech-to-text/build/start-transcribing-and-translating/http-basic-auth)获取 `Authorization` 值。
- 使用原生平台 v4.2.6.3 或 Web v4.20.1 及以上版本的 Video SDK,并支持 `datastreamEncryptionEnabled`。
- 在云端录制的 `start` 请求体中将 `enableNTPtimestamp` 参数设置为 `true`,以便与转写时间戳对齐。
云端录制 `start` 请求体示例
```json
"recordingConfig": {
"maxIdleTime": 30,
"streamTypes": 2,
"channelType": 1,
"extensionParams": {
"enableNTPtimestamp": true
},
"transcodingConfig": {
"width": 1280,
"height": 720,
"fps": 15,
"bitrate": 2400,
"mixedVideoLayout": 3,
"layoutConfig": [
{
"alpha": 1,
"height": 1,
"render_mode": 1,
"uid": "22228",
"width": 1,
"x_axis": 0,
"y_axis": 0
}
]
}
},
```
## 实现方法 [#实现方法]
按照以下步骤录制字幕,并与对应录制文件同步以便顺畅回放。
### 录制字幕 [#录制字幕]
按照[快速开始](/zh-CN/realtime-media/speech-to-text/get-started/quick-start)中的 API 调用流程,并在 `start` 请求中加入字幕录制参数,如下所示:
```shell
curl --location --request POST 'https://api.sd-rtn.com/cn/api/speech-to-text/v1/projects/{appId}/join' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ' \
--data '{
"name": "unique-agent-id",
"languages": [
"en-US"
],
"maxIdleTime": 50,
"rtcConfig": {
"channelName": "",
"subBotUid": "",
"subBotToken": "",
"pubBotUid": "",
"pubBotToken": ""
},
"captionConfig": {
"storage": {
"accessKey": "",
"secretKey": "",
"bucket": "",
"vendor": ,
"region": ,
"fileNamePrefix": ["folder","sub-folder"]
},
"extensionParams": {
"endpoint": endpoint,
"type": type,
"provider": provider,
}
}
}'
```
:::info[信息]
当 `captionConfig.storage.vendor` 为 `11` 时,你需要在 `captionConfig.extensionParams` 中补充标准 S3 存储的接入信息。
:::
### extensionParams 字段说明 [#extensionparams-字段说明]
| 字段 | JSON 类型 | 必填 | 含义与作用 | 生效范围与注意 |
| --- | --- | --- | --- | --- |
| `endpoint` | `string` | 视场景 | 兼容 S3 存储服务的访问地址,需要填写完整 URL,例如 `http://host:9002`。 | 当 `vendor` 为 `11` 时必填。它用于明确告诉系统文件要上传到哪个存储地址。若使用自签 HTTPS 证书,需要先在运行环境中信任该证书,否则可能连接失败。 |
| `provider` | `string` | 建议填写 | 兼容 S3 存储服务的供应商名称,例如 MinIO 对应 `Minio`。 | 通常与 `endpoint` 一起填写,用于说明连接的是哪家兼容 S3 服务。注意大小写需要与供应商名称要求保持一致。 |
| `type` | `string` | 建议填写 | 存储类型。标准 S3 场景固定填写为 `s3`。 | 通常与 `storage.vendor = 11` 配合使用,用于告诉系统按 S3 协议处理该存储。 |
| `region` | `string` | 否 | 存储区域标识。供 AWS SDK 兼容客户端使用。 | 如果同时在 `storage.region` 和 `extensionParams.region` 中填写,系统会优先使用 `extensionParams.region`。|
| `tag` | `string` | 否 | 上传到云存储后的对象标签基础值。 | 仅当 `storage.vendor` 为腾讯云、阿里云或 Amazon S3 时生效;`vendor = 11` 时当前不生效。 |
| `tagByRule` | `array` | 否 | 按文件名规则自动追加对象标签,例如给不同类型文件打不同标签。 | 与 `tag` 同时存在时优先按规则生成标签;仅腾讯云、阿里云和 Amazon S3 生效,`vendor = 11` 不生效。 |
| `sse` | `string` | 否 | 服务端加密方式。`aes256` 表示 AES256,`kms` 表示 AWS KMS。 | 仅 Amazon S3 生效;`vendor = 11` 时当前不读取该字段。 |
| `overwritekeys` | `array