文档中心

实时音视频

请输入

开始使用

迁移至新版接口

本指南适用于已接入旧版接口 StartVoiceChat（2024-12-01）、UpdateVoiceChat（2024-12-01）、StopVoiceChat（2024-12-01）的业务，目标是迁移至新版接口 2025-06-01。如果您当前已在使用 2025-06-01 版本，则无需重复迁移。

核心差异

对比维度	2025-06-01（新版）	2024-12-01（旧版）	您需要做什么
AppId 来源	使用 AI 音视频互动方案的应用 AppId。	使用实时音视频的应用 AppId。	同时更新 RTC 鉴权 Token 生成逻辑，以及 StartVoiceChat、UpdateVoiceChat、StopVoiceChat 请求中的 AppId。
OpenAPI 版本	Version 为 2025-06-01。	Version 为 2024-12-01。	将所有相关接口的 Version 统一改为 2025-06-01。
模型资源接入方式	方舟 LLM、豆包语音 ASR/TTS 均支持使用公共资源，也支持继续使用自定义开通的模型。	方舟 LLM、豆包语音 ASR/TTS 使用的是自定义开通的模型。	迁移时建议先判断：是继续使用自定义开通的模型，还是切换到公共资源。不同选择对应的配置调整不同。
计费模式	支持 Tokens 计费，具体规则参见 AI 音视频互动方案计费。	服务均独立计费。	/

迁移步骤

步骤 1：开通 AI 音视频互动方案服务

前往 AI 音视频互动方案控制台，首次进入时按照界面提示完成服务开通。

完成开通后，系统会为您创建默认应用。迁移初期建议优先使用该默认应用进行联调。

步骤 2：调整 RTC 鉴权逻辑

新版接口要求使用 AI 音视频互动方案的应用 AppId、AppKey 重新为客户端生成 RTC 鉴权 Token。

在 AI 音视频互动方案-应用管理页面，找到目标应用并获取其 AppId、AppKey。迁移初期建议先使用默认应用。

注意

首次开通时赠送的免费 Tokens，仅对 AI 音视频互动方案系统默认创建的应用生效。您后续自行创建的其他应用，无法使用这部分免费额度。

替换 RTC Token 鉴权代码中的 AppId、AppKey。

确保客户端入房使用的 RTC 鉴权 Token，与 OpenAPI 请求中传入的 AppId 来自同一个 AI 音视频互动方案应用。

步骤 3：更新 OpenAPI 请求参数

更新 StartVoiceChat、UpdateVoiceChat、StopVoiceChat 接口的以下参数：

Version 改为 2025-06-01。

AppId 改为步骤 1 中获取的 AI 音视频互动方案应用 AppId。

根据您对模型资源的选择，检查 LLMConfig、ASRConfig、TTSConfig。

场景一：继续使用自定义开通的模型
场景二：切换到公共模型资源
如果您在旧版中接入的是火山方舟模型、豆包语音 ASR/TTS，并且迁移后仍想继续使用这些自定义开通的模型资源，可按以下规则处理：
方舟模型：新版接口中需改为传入 ModelName 和 APIKey。其中，ModelName 填写方舟模型的 Model ID 或接入点 ID。
豆包语音 ASR/TTS：无需更改。
示例：

"LLMConfig": {
"Mode": "ArkV3",
"ModelName": "YOUR_MODEL_ID_OR_ENDPOINT_ID",
"APIKey": "<YOUR_API_KEY>", // 补充 APIKey
"SystemMessages": ["..."]
}
如果您希望将火山方舟模型、豆包语音 ASR、豆包语音 TTS 切换到平台提供的公共资源，则三者都需要调整配置：
注意
上述资源切换到公共资源后，费用会折算为 Tokens 计费，可通过 Tokens 资源包抵扣。具体计费规则，请参见 AI 音视频互动方案计费。
方舟模型：改为传入 ModelName，不再使用自定义方舟模型的鉴权方式。
豆包语音 ASR：去掉豆包语音 ASR 的鉴权参数，例如 AppId、AccessToken，或 Credential.AppId、Credential.AccessToken。
豆包语音 TTS：
去掉豆包语音 TTS 的鉴权参数，例如 app.appid、app.token，或 Credential.AppId、Credential.Token。
如果使用的是声音复刻，原来自定义开通模型下的音色 ID 不能直接复用。还需要在 AI 音视频互动方案控制台购买并训练音色，然后将 voice_type 替换为新生成的音色 ID，并确保 ResourceId 与公共音色版本匹配。音色购买和训练方式，参考复刻声音。
示例：

"LLMConfig": {
"Mode": "ArkV3",
"ModelName": "YOUR_MODEL_NAME",
"SystemMessages": ["..."]
}

"ASRConfig": {
"Provider": "volcano",
"ProviderParams": {
"Mode": "bigmodel",
"ApiResourceId": "volc.seedasr.sauc.duration",
"StreamMode": 2
}
}

"TTSConfig": {
"Provider": "volcano_bidirection",
"ProviderParams": {
"audio": {
"voice_type": "zh_female_vv_uranus_bigtts"
},
"ResourceId": "seed-tts-2.0"
}
}

步骤 4：联调验证后上线

完成迁移后，建议至少验证以下内容：

使用新的 AppId、AppKey 生成的 RTC 鉴权 Token 可以正常入房。

StartVoiceChat 调用成功，AI 能正常加入房间并开始对话。

UpdateVoiceChat、StopVoiceChat 调用正常，原有业务流程没有回归问题。

若开启了字幕、回调、打断、视觉理解、记忆等能力，相关行为符合预期。

确认以上内容无误后，再逐步切换正式流量。

最近更新时间：2026.09.21 16:24:33

这个页面对您有帮助吗？

有用

无用