# 更新服务配置 (/zh-CN/realtime-media/speech-to-text/build/start-transcribing-and-translating/update-service) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 实时转录翻译支持 update 命令,你可以在不中断服务的情况下修改参数。 例如,仅对指定主播转写时,如果该主播掉线后以新的用户 ID 重新加入频道,需要让实时转录翻译订阅新的用户 ID 并继续转写其音频,`update` 命令即可解决此类问题。 `update` 命令可用于: - 更新转写语言。 - 更新需转写音频的指定主播的用户 ID。 - 在转写全部主播与转写指定主播之间切换。 ## 前提条件 [#前提条件] 开始前,请确保你的开发环境满足以下条件: - 参考[开通服务](/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` 值。 确保已为你的 App 启用实时转录翻译服务。 ## 实现方法 [#实现方法] 按照[快速开始](/zh-CN/realtime-media/speech-to-text/get-started/quick-start)中的 API 调用流程进行。 ### 请求示例 [#请求示例] - 更新转写语言: ```shell curl --location --request POST 'https://api.sd-rtn.com/cn/api/speech-to-text/v1/projects/{appId}/agents/{agentId}/update?sequenceId=1&updateMask=languages' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic ' \ --data '{ "languages": [ "en-US", "ru-RU" ] }' ``` - 更新用户 ID: ```shell curl --location --request POST 'https://api.sd-rtn.com/cn/api/speech-to-text/v1/projects/{appId}/agents/{agentId}/update?sequenceId=1&updateMask=rtcConfig.subscribeAudioUids' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic ' \ --data '{ "rtcConfig": { "subscribeAudioUids": ["12", "23", "45"], } }' ``` ### 响应示例 [#响应示例] - 成功 ```json { "agent_id": "Agent ID.", "create_ts": 12345678, "status": "RUNNING" } ``` - 失败 ```json { "message": "string" // error reason } ``` ## 注意事项 [#注意事项] - 调用 `update` 需要至少 5 秒间隔,具体如下: - 调用 `start` 后,需等待至少 5 秒才能调用 `update`。 - 调用 `update` 后,再次调用 `update` 前需等待至少 5 秒。 - `update` 与 `query`、`stop` 搭配时无间隔限制。 - 更新参数时,新的参数会完全替换旧参数,除非旧参数在 `updateMask` 中被忽略。例如,当前转写用户 ID 为 100 和 200 的主播,用户 ID 为 200 的主播掉线后以用户 ID 300 重入,则需要使用 `"subscribeAudioUids": "[ \"100\", \"300\" ]"`。如果仅使用 `"subscribeAudioUids": "[ \"300\" ]"`,则只会转写用户 ID 300 的主播音频,语言配置不会更新。 - 如果同时更新语言和主播的用户 ID,传入 `"updateMask=languages,rtcConfig.subscribeAudioUids"`。 - `sequenceId` 每次请求递增 1。